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Preface 



This publication describes the differences 
in internal logic of the control program 
that result from the inclusion of multipro- 
gramming with a fixed number of tasks 
(MFT). It is assumed that the reader of 
this publication is thoroughly familiar 
with the basic operation of the control 
program. Only areas of difference are dis- 
cussed in this publication. 

The manual is divided into four major 
sections. The Introduction describes con- 
trol program functions, control program and 
main storage organization, and control pro- 
gram processing flow. The Initialization 
of the Operating System section describes 
differences introduced by MFT into sys v tem 
initialization. The Supervisor section 
describes supervisor functions including an 
explanation of task dispatching in MFT. 

The Job Management section contains the 
changes to the job management components 
made by MFT. Job management is divided 
into three major components : reader/ 
interpreter, initiator/terminator, and out- 
put writer. Also described are the Queue 
Manager which is used by all three major 
job management components , the Communica- 
tions Task which handles operator-system 
communication, and the Master Scheduler 
Task which processes operator commands. 

Appendix A contains descriptions of 
major tables and work areas used by MFT. 
Appendix B contains descriptions of modules 
used by MFT. Appendix C contains MFT 
flowcharts. 

PREREQUISITE PUBLICATIONS 

Knowledge of the information in the fol- 
lowing publications is required for a full 
understanding of this manual. 



I BM System/360 Operating System: 



Principles of Operation , Form A22-6821 

Introduction to Control Program Logic , 
Program Logic Manual , Form Y28-6605 

Fixed-Task Supervisor, Program Logic 
Manual , Form Y28-6612 

MVT Job Management, Program Logic Manu- 
al, Form Y28-6660 



Initial Program Loader and Nucleus 
Initialization Program , Form Y28-6661 

Planning for Multiprogramming With a 
Fixed Number of Tasks (MFT) , Form 
C27-6939 



The following publications may be useful 
for reference although they are not prere- 
quisites for this publication. 



IBM System/360 Operating System: 

Concepts and Facilities , Form C28-6535 

Linkage Editor , Form C28-6538 

System Programmer ' s Guide , Form C28-6550 

System Generation , Form C28-6554 

MVT Control Program Logic Summary ,, Form 
C28-6658 

Input/Output Supervisor, Program Logic 
Manual, Form Y28-6616 
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Introduction 



In a single task environment, main storage 
is divided into two areas: the fixed area, 
and the dynamic area. In multiprogramming 
with a fixed number of tasks (MFT), the 
dynamic area is divided further into as 
many as fifty-two discrete areas called 
partitions. Figure 1 shows the division of 
main storage. 

| The fixed area, located in the lower 
portion of main storage, contains the resi- 
dent portion of the control program, and 
control blocks and tables used by the sys- 

| tern. The size of the fixed area depends on 
the number of partitions established by the 
user, and the control program options 
selected at system generation. 



Partitions are defined within the dynam- 
ic area, located in the upper portion of 
main storage, at system generation. The 
number of partitions may be varied within 
the number specified at system generation, 
and the sizes and job classes of partitions 
may be redefined at system initialization 
or during operation. (See I EM System/ 3 60 
Operating System: Planning for Multipro- 
gramming with a Fixed Number of Tasks 
(MFT) , Form C27-6939.) Each partition may 
be occupied by a processing program, or by 
control program routines that prepare job 
steps for execution (job management rou- 
tines), or handle data for a processing 
program (access method routines). 

i Provided the total number of partitions 
I does not exceed 52 and enough computing 



system resources are available, MFT pro- 
vides for the concurrent execution of as 
many as 15 problem programs, 3 input 
readers, and 36 output writers, each in its 
own fixed partition of main storage. The 
MFT system provides for task switching 
among the tasks operating in the parti- 
tions, and between those tasks and the com- 
munications task and master scheduler task 
in the system area. 



Task dispatching in MFT differs from the 
primary control program (PCP) primarily in 
that task switching is required, and that 
certain system functions such as abnormal 
termination must be carried out so that 
other, unrelated, tasks are not affected. 
The dispatching priority of a task is 
determined by the relative position of the 
partition used to process the task. The 
highest- priority partition (P0) is at the 
highest address in storage. Successively 
lower partitions (PI - P51) have correspon- 
dingly lower priorities. Control of the 
CPU is given to the program in the highest- 
priority partition that is ready. 



The integrity of programs operating 
under MFT is preserved if the storage pro- 
tection feature is included. MFT uses the 
16 protection keys to prevent a user job 
from modifying the control program or 
another job; it uses the two operating 
states of the CPU to restrict the use of 
control and I/O instructions. 
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Because many components of MFT are simi- 
lar to those of PCP and multiprogramming 
with a variable number of tasks (MVT) , many 
of the modules for a given MFT component 
are the same for the comparable component 
in either PCP or MVT. Therefore, this pub- 
lication describes differences between MFT 
and the other configurations. The corres- 
ponding PCP and MVT routines are described 
in the following IBM System/360 Operating 
System program logic manuals and are 
referenced where applicable: 

Fixed Task Supervisor , Form Y28-6612 

MVT Supervisor , Form Y28-6659 

MVT Job Management , Form Y28-6660 

Information on modified or new routines for 
MFT is contained in the three sections that 
follow this introduction. 

The Initialization of the Operating Sys- 
tem section describes how the dynamic area 
of main storage is prepared by the master 
scheduler task after completion of the Nuc- 
leus Initialization Program. 

The Supervisor section describes the 
task management modifications made to the 
supervisor for MFT. The major area of 
change has been in the initialization of 
main storage. 

The Job Management section describes 
modifications and additions to the routines 
for processing communications with the pro- 
grammer and the operator. The major 
changes are in the master scheduler task, 
and the MFT initiator. Other modifications 
have been made to the queue manager, the 
reader/interpreter, system output writer, 
and system task control routines . 

Functions of the Control 
Program with MFT 

As in PCP and MVT, the control program rou- 
tines of MFT have three major functions: 
job management, task management, and data 
management. 

JOB MANAGEMENT 

Job management is the processing of com- 
munications from the programmer and opera- 
tor to the control program. There are two 
types of communications: operator com- 
mands, which start, stop, and modify the 
processing of jobs in the system, and job 
control statements, which define work being 
entered into the system. Processing of 
these commands and statements is referred 
to as command processing and job proces- 
sing, respectively. 



TASK MANAGEMENT 

Task management routines monitor and con- 
trol the entire operating system, and are 
used throughout the operation of both the 
control and processing programs. Task man- 
agement has six major functions: 

• Interruption supervision. 

• Task supervision. 

• Main Storage supervision. 

• Contents supervision. 

• Overlay supervision. 

• Timer supervision. 

The task management routines are collec- 
tively referred to as the "supervisor." 



DATA MANAGEMENT 

Data management routines control all opera- 
tions associated with input/output devices: 
allocating space on volumes, channel sched- 
uling, storing, naming, and cataloging data 
sets, moving data between main and auxili- 
ary storage, and handling errors that occur 
during input/output operations. Data man- 
agement routines are used by processing 
programs and control program routines that 
reguire data movement. Processing programs 
use data management routines primarily to 
read and write required data, and also to 
locate input data sets and to reserve aux- 
iliary storage space for output data sets 
of the processing program. 

Data management routines are of five 
categories: 

• Input/Output (I/O) supervisor, which 
supervises input/output requests and 
interruptions . 

• Access methods, which communicate with 
the I/O supervisor. 

• Catalog management, which maintains the 
catalog and locates data sets on auxil- 
iary storage. 

• Direct-access device space management 
(DADSM) , which allocates auxiliary 
storage space. 

• Open/Close/End-of -Volume, which per- 
forms required initialization for I/O 
operations and handles end -of -volume 
conditions. 

The operation of these routines is identic- 
al with MVT and is described in the follow- 
ing IBM System/360 Operating System program 
logic manuals: 

Input/Output Supervisor , Form Y28-6616 

Sequential Access Methods , Form Y28-6604 
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Indexed Sequential Access Methods , Form 
Y28-6618 

Basic Direct Access Method , Form 
Y28-6617 

Graphics Access Method , Form Y27-7113 

Catalog Management , Form Y28-6606 

Direct Access Device Space Management , 
Form Y28-6607 

Input/Output Support (OPEN/ CLOSE/ EOV) , 
Form Y28-6609 



Control Program Organization 

The control program is on auxiliary storage 
in three partitioned data sets created when 
the system is generated. These data sets 
are: 

• The NUCLEUS partitioned data set (SYS1. 
NUCLEUS), which contains the Nucleus 
Initialization Program (NIP) and the 
resident portion of the control 
program. 

• The SVCLIB partitioned data set (SYS1. 
SVCLIB), which contains nonresident SVC 
routines, nonresident error-handling 
routines, and the access methods 
routines . 

• The LINKLIB partitioned data set (SYS1. 
LINKLIB), which contains other nonresi- 
dent control program routines and IBM- 
supplied processing programs. 



RESIDENT PORTION OF THE CONTROL PROGRAM 

The resident portion (nucleus) of the con- 
trol program is in SYS1. NUCLEUS. It is 
made up of those routines, control blocks, 
and tables that are brought into main 
storage at initial program loading (IPL) 
and are never overlaid by another part of 
the operating system. The nucleus is 
loaded into the fixed area of main storage. 

The resident task management routines 
include all of the routines that perform: 

• Interruption supervision. 

• Main storage supervision. 

• Timer supervision. 

They also include portions of the routines 
that perform: 

• Task supervision. 

• Contents supervision. 

• Overlay supervision. 



These routines are described in the Super- 
v isor section of this publication, and in 
the program logic manual IBM System/360 
O perating System: Fixed Task Supervisor , 
Form Y28-6612. 

The resident job management routines are 
those routines of the communications task 
that receive commands from the operator. 
The MFT communications task is described in 
this publication. 

The resident data management routines 
are the input/output supervisor and, 
optionally, the BLDL routines of the parti- 
tioned access method. These routines are 
described in the following IBM System/360 
Operating System program logic manuals: 

Input/Output Supervisor , Form Y28-6616 

Sequential Access Method , Form Y28-6604 

The user may also select resident reen- 
terable routines, which are access method 
routines from SYS1. SVCLIB, and other reen- 
terable routines from SYS1. LINKLIB. At 
system generation, the user specifies that 
he wants such routines resident in main 
storage. At IPL, he identifies the specif- 
ic routines desired in the RAM=entry. The 
selected routines are loaded during system 
initialization and reside adjacent to the 
higher end of the system queue area unless 
the BLDL table is also resident (see Figure 
1). 

Normally- transient SVC routines (i.e. , 
types 3 and 4 SVC routines) can be made 
resident through the RSVC option, specified 
by the user. NIP loads these routines 
adjacent to the higher end of the resident 
reenterable routines. If there is no resi- 
dent BLDL table or resident reenterable 
routines, the routines are loaded adjacent 
to the higher end of the system queue area. 
(See Figure 1.) 



NONRESIDENT PORTION OF THE CONTROL PROGRAM 

The nonresident portion of the control pro- 
gram comprises routines that are loaded 
into main storage as they are needed, and 
which can be overlaid after their comple- 
tion. The nonresident routines operate 
from the partitions and from two sections 
of the nucleus called transient areas 
(described below) . 



Main Storage Organization 

Main storage in MFT is organized similarly 
to main storage in MVT, except that the 
optional resident areas are adjacent to the 
nucleus. 
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Main storage may be expanded by includ- 
ing IBM 2361 Core Storage (core storage) 
units in the system. Main Storage Hierar- 
chy Support for IEM 2361 Models 1 and 2 
permits access to either processor storage 
(hierarchy 0) or core storage (hierarchy 
1) . Each partition established during sys- 
tem generation is described by a boundary 
box. The first half of the boundary box 
describes the processor storage partition 
segment and the second half describes the 
core storage partition segment . Any parti- 
tion segment not assigned main storage in 
the system has the applicable boundary box 
pointers set to zero. If a partition is 
established entirely within hierarchy 1, 
the processor storage pointers in the first 
half of the partition f s boundary box are 
set to zero. If a partition segment is not 
generated in core storage , the core storage 
pointers in the second half of the parti- 
tion's boundary box are set to zero. If 
core storage has been included in the sys- 
tem, but is offline, the second half of the 
boundary box will contain zeros. If core 
storage is excluded from the system, the 
second half of the boundary box is not 
generated. 



FIXED ABE A 

In MFT (as in PCP and MVT) the fixed area 
is that part of main storage into which the 
nucleus is loaded at IPL. The storage pro- 
tection key of the fixed area is zero so 
that its contents can be modified by the 
control program only. The fixed area also 
contains two transient areas into which 
certain nonresident routines are loaded 
when needed: the SVC transient area (1024 
bytes) and the I/O supervisor transient 
area (1024 bytes). These areas are used by 
nonresident SVC routines and nonresident 
I/O error- handling routines, respectively, 
which are read from SYS1.SVCLIB. 



Each transient area contains only one 
routine at a time. When a nonresident SVC 
or error- handling routine is required, it 
is read into the appropriate transient 
area. The transient area routines operate 
with a protection key of zero, as do other 
routines in the fixed area. 



System Queue Area 

The system queue area (SQA) is established 
by NIP adjacent to the fixed area and pro- 
vides the main storage space required for 
tables and queues built by the control pro- 
gram. The SQA must be at least 16 00 bytes 
for a minimum two-partition system. Its 
storage protection key is zero so that it 
can be modified by control program routines 
only. Data in the system queue area indi- 
cates the status of all tasks. 



DYNAMIC AREA 

Figure 2 shows how the contents of each 
partition in the dynamic area are organized 
and how they are related to the rest of 
main storage. Routines are brought into 
the high or low portion of an MFT partition 
similarly to the way routines are brought 
into the entire dynamic area of PCP. Job 
management routines, processing programs, 
and routines brought into storage via a 
LINK, ATTACH, or XCTL macro instruction, 
are loaded at the lowest available address. 
The highest portion of the partition is 
occupied by the user parameter area and 
user save area. The next portion of the 
partition is occupied by the task input/ 
output table (TIOT) which is built by a job 
management routine (I/O Device Allocation 
routine) . This table is used by data man- 
agement routines and contains information 
about DD statements. 



Each partition may be used for a problem 
program as well as for system tasks 
(readers, initiators, and writers). When 
the control program requires main storage 
to build control blocks or work areas, it 
obtains this space from the partition of 
the processing program that requested the 
space. Access method routines and routines 
brought into storage via a LCAD macro 
instruction are placed in the highest 
available locations below the task input/ 
output table. 



Working storage and data areas are 
assigned from the highest available storage 
in a partition. 
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Theory o£ Operation 



Figure 3 describes the overall processing flow through each job cycle. These paragraphs 
describe the processing performed by various components of the control program as it 
loads the nucleus, reads control statements, initiates the job step, causes processing to 
begin or end in other partitions, and terminates the job step. 
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To load the nucleus, the operator sets 
the LOAD UNIT switches to the device on 
which the system residence volume is 
mounted, and presses the LOAD button on the 
operator control panel. This causes an I PL 
record to be read and to be given control. 
This record causes the second I PL record to 
be read, which in turn, enables the rest of 
the IPL program to be read into main 
storage. 



The IPL program searches the volume 
label of the system residence volume to 
locate the volume table of contents (VTOC) . 
The VTOC is then searched for the address 
of the nucleus data set (SYS1. NUCLEUS) . 
The nucleus is brought into the system 
area, and NIP is brought into the dynamic 
area. NIP receives control from the IPL 
program. It performs both required and 
optional initialization for control program 
operation including initializing the Com- 
munication Vector Table (CVT) , and general 
system initialization, such as determining 
user options. After completing its proces- 
sing, NIP passes control to the master 
scheduler task (MST) which initializes main 
storage. 



Partitions are established by the master 
scheduler at system initialization accord- 
ing to the sizes and job class (es) estab- 
lished at system generation by the PARTITNS 
macro instruction. The MST also places a 
copy of the Initiator /Terminator into each 
scheduler- size partition; a copy of the 
small partition module is placed in each 
small partition. The communications task 
receives control from the MST and communi- 
cates with the operator to request any par- 
tition changes. After the requested 
changes, if any, have been made by the 
definition routines, the work queues are 
initialized. The automatic commands are 
displayed, and the READY message is issued. 



Figure 3. MPT Theory of Operation (Part 1 of 4) 
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Vihen the required SET command is 
entered, the comm ion icat ions task calls the 
master scheduler command scheduling routine 
to have the command executed. An automatic 
START reader command or a subsequent opera- 
tor entered START reader command causes a 
copy of the Reader/Interpreter (reader) to 
be brought into its appropriate partition. 
If a START writer command is entered , a 
copy of a writer is also brought into the 
specified partition ( s) . 



Vihen the reader gets control, it reads 
control statements and data from the input 
job stream. Information from the JOE, 
EXEC, and DD statements controls the execu- 
tion of each job step. This information is 
placed in the following tables: 

• Job control table (JCT) for the job 
being read. 

• Step control table (SCT) for the step 
being read. 

• Data set enqueue table (DSENQ) for the 
job being read. 

• Job file control block (JFCB) and step 
input/output table (SICT) for each data 
set being used or created by the job 
step. 

• Volume table (VOLT) containing each 
volume serial number to be used by the 
job. 

Information from these tables and control 
blocks is updated with information in the 
data control block (DCB) and data set con- 
trol block (DSCB) or volume label when a 
data set is opened during step execution. 



The reader then places these updated 
control blocks into the input work queue 
corresponding to the CLASS parameter on the 
JOB statement. Data sets in the input 
stream are written onto a direct-access 
storage device for later use by the problem 
program. 



After the reader has completed proces- 
sing all input for a job and has entered 
the job on an input work queue, all initia- 
tors that are waiting for that job class 
are posted. If the job is for a small par- 
tition, the small partition module is also 
posted. 



Figure 3. MFT Theory of Operation (Part 2 of 4) 
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After receiving control, the initiator/ 
terminator prepares to initiate the highest 
priority job in its primary input work 
queue. Using information which the reader 
extracted from the DD statement, the 
initiator /terminator processes the user 
accounting routine, in addition to the 
following: 

Locates Input Data Sets : The Allocation 
routine, running as a subroutine of the 
initiator /terminator, determines the volume 
containing a given input data set by 
examining the JFCB, or by searching the 
catalog. This search is performed by a 
catalog management routine entered from 
allocation. (A description of the routines 
that maintain and search the catalog is 
given in IBM System/36 Operating System: 
C atalog Management, Program Logic Manual , 
Form Y28-6606.) 

A llocates I/O Devices : A job step cannot 
be initiated unless there are enough I/O 
devices to fill its needs. Allocation 
determines whether the required devices are 
available, and makes specific assignments. 
If necessary, messages are issued to the 
operator to request the mounting of 
volumes. 

A llocates Auxiliary Storage Space : Direct 
access volume space required for output 
data sets of a job step is acquired by the 
allocation routine, which uses the Direct 
Access Device Space Management (DADSN) rou- 
tines. (A description of the operation of 
the DADSM routines is given in the publica- 
tion IBM System/360 Operating System: 
Direct Access Device Space Management, Pro- 
g ram Logic Manual , Form Y28-6607.) 

The JFCB, which contains information 
concerning the data sets to be used during 
step execution, is written on auxiliary 
storage. This information is used when a 
data step is opened, and when it is closed, 
the job step is terminated. 

The initiator causes itself to be 
replaced by the problem program it is 
initiating (if for a large partition) , or 
initiates the job in a small partition. 

Ihe problem program can be an IBM- 
supplied processor (e.g., COBCI, linkage 
editor) , or a user-written program. The 
problem program uses control program ser- 
vices for operations such as loading other 
programs and performing I/O operations. 



Figure 3. MFT Theory of Operation (Part 3 of 4) 
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The problem program processes until it 
terminates either normally or abnormally, 
though it may not retain exclusive control 
of the CPU. Control always is received by 
the highest priority task that is ready to 
execute. 

When the problem program terminates, the 
supervisor receives control. The supervi- 
sor uses the OPEN/CLOSE/ECV routines to 
close any open data control blocks. (These 
routines are described in IBM System/360 
Operating System: Input/Output Support 
(OPEN/CLOSE/EQV) , Program Logic Manual , 
Form Y28-6609.) 

Under abnormal termination conditions f 
the supervisor may also provide special 
termination procedures , such as a storage 
dump. The supervisor passes control to the 
initi a tor /terminator, which is either 
brought into the partition in which ter- 
mination is to occur, or is brought into 
the large partition to terminate a small 
partition. 

The initiator /terminator releases the 
I/O devices, and disposes of data sets used 
and/or created during the job step by read- 
ing tables prepared during initiation (JCT, 
SCT, TI0T, etc.). These tables include 
information such as disposition of data 
sets. It then executes an installation 
accounting routine if one is provided. 

At job termination, an entry is made on 
the user specified output work queue; later 
the problem program output data can be 
written by a system output writer from a 
system direct-access storage device to a 
user-specified device. The initiator/ 
terminator then initiates the next job 
step. 

An output writer operates concurrently 
with readers, problem programs, and other 
writers. When the START command is issued 
for a writer, the writer dequeues the first 
entry in the specified output (SYSOUT) 
queue. If no requests have been enqueued 
in that output queue from the problem pro- 
grams, the writer is placed in a wait con- 
dition until a job is terminated that has 
system messages or output data sets. After 
the entry is dequeued from the output 
queue, the writer transmits the data sets 
to the specified card punch, magnetic tape 
unit, or printer. When the last record has 
been processed, the writer deletes the 
queue entry before dequeuing the next 
entry. 



Figure 



MFT Theory of Operation (Part 4 of 4) 
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I Initialization of the Operating System 



When the system is loaded , routines perform 
required and optional initialization of 
functions needed for control program opera- 
tion. (These routines are described in IBM 
System/360 Operating System: Initial Pro- 



gram Loader and Nucleus Initialization Pro- 
gram, Program Logic Manual , Form Y28-6661.) 
When the Nucleus Initialization Program 
(NIP) has defined the fixed area, it then 
assigns the rest of main storage to the 
master scheduler task to be prepared as the 
dynamic area for control program operation. 



Main Storage Preparation 



When NIP completes its functions it con- 
structs a request block (RB) and an XCTL 
macro instruction (specifying master sched- 
uler initialization routine IEFSD569) at 
the low address of the temporary master 
scheduler area. NIP places the address of 
this RB in master scheduler task TCB field 
TCBRBP. (The original contents of TCBRBP 
are saved and passed to IEFSD569 in a pa- 
rameter list along with the original master 
scheduler task boundary box contents.) NIP 
sets master scheduler task TCB field 
TCBFLGS to make the master scheduler, task 
dispatchable, and then branches to the 
dispatcher. 



The dispatcher gives control to the 
master scheduler task causing execution of 
the XCTL instruction which NIP placed in 
the temporary master scheduler area. The 
master scheduler initialization routine is 
brought into the temporary master scheduler 
area and begins executing. Figure 4, 
excluding the medium shaded area, illus- 
trates main storage at completion of NIP 
before branching to the dispatcher. Figure 
4, excluding the light shaded area, illus- 
trates main storage when the master sched- 
uler initialization routine receives con- 
trol from the dispatcher. 



For a description of the master schedul- 
er initialization routine see "Master 



Scheduler Task" in the Job Management sec- 
tion. Figure 5 illustrates main storage 
(four partition example) at completion of 
master scheduler initialization. When the 
initialization routine completes proces- 
sing, it branches to the dispatcher. 



Initializing the Partitions 



During master scheduler initialization the 
operator must accept automatic START com- 
mands or enter START commands manually. 
When a START command is processed, the par- 
tition number specified in the command is 
determined, and a CSCB is built. The CSCB 
(see Appendix A) is used for communication 
between the command scheduling routines 
(SVC 34) and the command execution rou- 
tines. The address of the CSCB is placed 
in the partition information block (PIB) of 
the specified partition, and the partition 
is posted. The PIB for each partition con- 
tains information used by command proces- 
sing and scheduler routines. (See Appendix 
A for a description of the PIB, and 
"Initiator /Terminator" in Job Management 
for a discussion of its use.) 



After the initialization routine com- 
pletes processing, the dispatcher gives 
control to the master scheduler router rou- 
tine. When this routine completes proces- 
sing, it returns to the dispatcher which 
begins searching the TCB queue. The high- 
est priority task posted through START com- 
mand processing receives control. The XCTL 
macro instruction addressed by the parti- 
tion's RB is executed and the Job Select 
module (IEFSD510) or Small Partition module 
(IEFSD599) is brought into the partition. 
When an interruption occurs and the parti- 
tion can no longer retain control, the dis- 
patcher gives control to the next posted 
partition. This process continues , enabl- 
ing all posted partitions to receive con- 
trol and to execute the XCTL instruction 
placed in them by the initialization 
routine . 



18 



High Address 



Partition 



Partition 



1 



Partition 
2 



Partition 



BLDL 
RSVC 
Resident -^ 
Reenterable 
Routines 



System 
Queue -< 
Area 



Nude 



RB 



ft 



XCTL 1EFSD510 



0000 FQE 



RB 



ft 



XCTL IEFSD510 



0000 FQE 



RB 



ft 



(Small Partition) 



XCTL IEFSD599 



0000 FQE 



Master Scheduler Initialization Routine 
(IEFSD569) 




0000 FQE 



Communications Task 



JVISTCB_ 
TCBRBP 

fCBMSS 



I 



*► RB 



SQA BB0X 



JVISBBOX 

_ Hl_- 
LO - 



Master Scheduler 



Low Address 

•Figure 4 . Main Storage During Execution of NIP 



Dynamic 
Area 



. Fixed 
Area 



Initialization of the Operating System 19 



Temporary 
Master 
Scheduler 
Area 



> 



BLDL 
RSVC 
Resident -^ 
Reenterable 
Routines 



System 
Queue Area 



Nucleus ■< 



High Address 



Executed IPL Program Instructions 



NIP Instructions 



Master Scheduler Initialization Routine 
(IEFSD569) 



RB 



XCTL IEFSD569 



0000 FQE 



0000 FQE 



Communications Task 



Master Scheduler 



MSTCB 
TCBRBP 



TCBMSS 



RB 




SQA BBOX 



MS BBOX 



Hl_ 
~LO 



Low Address 



f 



Dynamic 
Area 



Fixed 
Area 



Legend: 



t»i;"'S..r - r-j 



Contents of the Dynamic Area During IPL and NIP. 

Contents of the Dynamic Area After The Master Scheduler Task 
Receives Control on Completion of NIP. 

Optional Features 



•Figure 5. Main Storage at Termination of Master Scheduler Initialization 



20 



Supervisor 



The MFT Supervisor manages the operation of 
the control program and processing pro- 
grams. Job management selects jobs for 
execution, allocates devices and storage to 
the step to be executed, and gives control 
to the program that represents the step. 
After receiving control, a program is known 
as a task and becomes the responsibility of 
the Supervisor. As many as 15 job-step 
tasks may operate in the system concurrent- 
ly with system tasks. Each task must be 
isolated so it does not interfere with any 
other task. To do this, each job-step task 
operates in its own partition in main 
storage. If the system has the optional 
storage protection feature, each partition 
is assigned a unique protection key (1-15). 
The resident portion of the control pro- 
gram, including some supervisor routines, 
occupies a fixed area of main storage and 
operates under a protection key of zero. 

To maintain control of the computing 
system, the supervisor must perform many 
services. Routines within the supervisor 
are grouped into general categories depend- 
ing upon the services which they perform. 
These categories are: 

Interruption Supervision ; All supervisor 
activity begins with an interruption. The 
five types of interruptions are: supervi- 
sor call, timer/ ext ernal , input/ output, 
program, and machine. When an interruption 
occurs, the interruption handling routine 
for the type of interruption that occurred 
gains control . The interruption handling 
routine then passes control to those parts 
of the control program that perform the 
services required as a result of the inter- 
ruption. Many of the services which must 
be performed are included in other general 
categories of the supervisor. 

Task Supervision : The supervisor maintains 
control information including the current 
status of program and interruption request 
blocks, task control blocks, and event con- 
trol blocks. 

Contents Supervision : The supervisor keeps 
records of the status and characteristics 
of all programs in each partition of main 
storage, initiates program fetch for the 
dynamic loading of programs, and maintains 
the active request block queue. 

Main Storage Supervision : Within each par- 
tition, the supervisor allocates and 
releases main storage space for a task on 
request, and maintains a record of all free 
storage space within each partition. 



T imer Supervision : The supervisor sets and 
maintains a clock, and honors requests for 
time intervals and exact time. 

Overlay Supervision : The supervisor mon- 
itors the flow of control between segments 
of a program operating in an overlay struc- 
ture established by the user through the 
linkage editor. 



Interruption Supervision 

With the exception of the dispatcher and 
the ABEND routines which are described 
below, the interruption supervisor of MFT 
functions as described in IBM System/360 
Operating System: Fixed -Task Supervisor, 
Program Logic Manual , Form Y28-6612. 

When an interruption occurs and is ser- 
viced, the task which had been executing 
may relinquish control of the CPU. Control 
must always be given to the highest priori- 
ty ready task. The transfer of control 
from one task to another is called task 
switching and is accomplished by the task 
dispatcher. When an interruption handling 
routine completes processing an interrup- 
tion, it branches to the task dispatcher 
rather than returning control to the inter- 
rupted program. Type 1 EXIT is the only 
interruption handling routine which may 
return control directly to the interrupted 
program. Figure 6 illustrates how the task 
dispatcher receives control after an inter- 
ruption has been serviced. 



THE DISPATCHER (MACRO IEAAPS) 

The dispatcher gives control to the highest 
priority task ready to execute. It uses 
information located by communication vector 
table (CVT) fields CVTHEAD and CVTTCBP, and 
if the time- si icing feature is in the sys- 
tem, field CVTTSCE. 

Field CVTHEAD addresses a queue of task 
control blocks (TCBs). This TCB queue is 
arranged in dispatching priority order 
beginning with the highest priority task. 
The highest priority TCB is the optional 
log task TCB, followed by the communication 
task TCB, the master scheduler task TCB, 
and one TCB for each of the partitions 
generated in the system (in ascending order 
by partition number). Figure 7 illustrates 
the TCB queue. 
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Figure 6 . MFT Supervisor 



Any number of partitions (up to 52) may 
be specified during system generation. 
Partitions must be numbered consecutively 
beginning with zero. Note that in Figure 7 
there is a TCB for partition 1, but parti- 
tion 1 is assigned no storage space. This 
illustrates a partition which was specified 
at system generation but which has been 
made inactive. If a partition is not spe- 
cified during system generation, no TCB is 
constructed. If f for example, only 3 par- 
titions (0 through 2) are specified at sys- 
tem generation, then only three TCBs are 
constructed and partitions 3 through 51 do 
not exist. 



All of the TCBs in the system are 
chained together through TCB field TCBTCB. 
In each TCB, this field contains the 
address of the next TCB on the queue. The 
TCBTCB field of the last TCB on the queue 
contains zero. 



CVT field CVTTCBP addresses two full 
words called NEW and OLD. The first word 
(NEW) contains either zero or the TCB 
address for the task to be given control. 
The second word (OLD) contains the TCB 
address for the task currently in control. 
NEW can be set by any of the supervisory 
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routines associated with task switching 
(WAIT, POST, ENQ/DEQ, Manual Purge). When 
a supervisory routine determines that the 
task currently in control can no longer 
retain control, it sets NEW to zero. When 
a supervisory routine determines the new 
task to be given control, it inserts the 
TCB address for that task in NEW. 

CVT field CVTTSCE contains the address 
of t*he time-slice control element (TSCE). 
This field is used by the dispatcher in 
determining the next time-slice task to 
receive control, providing time-slicing was 
specified as a system generation option. 
The format of a TSCE is explained later in 
this section. 



When the interval timer is in use and a 
user accounting routine is supplied, the 



dispatcher accumulates the total amount of 
time used to execute a job step. Each time 
a new job step is dispatched, the dispatch- 
er stores the time from the hardware timer 
in the PTIMER field of IEATPC (pseudo clock 
area) . When control is returned to the 
dispatcher, it calculates the elapsed time 
by subtracting the stored value from the 
current value of the hardware timer. The 
dispatcher adds the result to the TCBTCT 
field in the task's TCB. Time is not cal- 
culated for the job step if it is dis- 
patched in a wait state. 



Dispatching a Task 

When the dispatcher receives control, it 
first schedules any requests for system 
asynchronous exit routines. Then it deter- 
mines if NEW equals OLD (see Chart 01). If 
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•Figure 7. TCB Queue 
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so, no task switch is indicated. If neces- 
sary, the dispatcher enqueues timer ele- 
ments for the task. It then returns to the 
task currently in control . 

If NEW does not equal OLD, a task switch 
is indicated. If job/step CPU timing is 
included in the system, the dispatcher cal- 
culates the job step time for OLD, and 
increments the job time accumulator in the 
TCB. If necessary, the dispatcher dequeues 
timer elements associated with the task 
currently in control. Then it determines 
if NEW equals zero. 

If NEW does not equal zero, it contains 
the TCB address for the task to be given 
control. The dispatcher sets OLD equal to 
NEW, and enqueues timer elements if neces- 
sary. Additionally, if job/step CPU timing 
is included in the system, the dispatcher 
stores the interval timer value in the 
pseudo timer field of IEATPC. Control then 
passes to the new task. 

If NEW equals zero, the dispatcher must 
examine the TCB queue to determine which 
task should be given control. This 
examination begins with the TCB addressed 
by OLD. (For a task of higher priority 
than OLD to receive control, the address of 
its TCB must be inserted in NEW by a super- 
visory routine.) 

When examining a TCB to determine if its 
associated task should be given control, 
the dispatcher first determines if the re- 
quest block (RB) of the program executing 
under the TCB is waiting. This is done by 
examining field XRBWT in the RB addressed 
by TCB field TCBRBP. If the RB is not 
waiting, the dispatcher examines TCB field 
TCBFLGS to determine if the task is dis- 
patchable. If so, the dispatcher sets NEW 
and OLD to the address of the TCB and 
enqueues timer elements (if necessary). 
Additionally, if job/ step CPU timing is 
included in the system, the dispatcher 
stores the interval timer value in the 
pseudo timer field of IEATPC. Control then 
passes to the new task. 



In one case, the dispatcher does not 
pass control directly to the new task. If 
TCB field TCBRBP for the task to be given 
control addresses an SVRB for a transient 
SVC routine, a check is made to determine 
the contents of the double word XCNTCC (in 
IEAATAOO) which contains the name of the 
routine presently in the SVC transient 
area. If the routine names in XCNTCC and 
the SVRB are identical, the dispatcher 
passes control to the new task. If they 
are not identical, the Transient SVC 
Refresh routine (IEAARFOO) brings the 
required routine into the SVC transient 



area and then returns to the dispatcher. 
Since NEW and OLD have already been set 
equal, the dispatcher need only enqueue 
timer elements if necessary and pass con- 
trol to the new task. 

If the RB for a task is waiting or the 
task is nondispatchable, the task is not 
ready to receive control. The dispatcher 
examines TCB field TCBTCB to obtain the 
address of the next TCB on the queue. The 
dispatcher then examines this TCB to iden- 
tify whether it is ready to receive con- 
trol. This process continues until a ready 
task is found or until the end of the queue 
is reached (indicated by a zero in TCBTCB). 

If no task is able to receive control, 
the dispatcher sets the resume PSW wait bit 
of the TCB addressed by OLD. This PSW is 
then loaded, placing the CPU in a wait con- 
dition. The resume PSW is located in field 
XRBPSW of the RB addressed by TCB field 
TCBRBP. 

Figures 8 and 9 illustrate how control 
is switched assuming a three partition sys- 
tem in which Pi is inactive (see Figure 7). 
All tasks are dispatchable except task PI. 
Initially, only the communications task and 
master scheduler task are waiting. Because 
task PO is the highest priority task which 
is dispatchable and not waiting, it is 
given control. Task PO has already 
enqueued and received exclusive control of 
a resource which task P2 will later enqueue 
(see Figure 9) . 

D ispatching the Communications Task and 
Master Scheduler Task 

Figure 8 illustrates how control passes to 
the communications task and master schedul- 
er task through the dispatcher. In the 
example illustrated, the communications 
task receives control in order to read a 
DEFINE command from the operator console. 

Initially, the task in PO has received 
control from the dispatcher and is execut- 
ing. The operator presses the REQUEST key 
to indicate that he wishes to enter a com- 
mand from the console. An I/O interruption 
is generated and control passes to the I/O 
supervisor which identifies the interrup- 
tion as an attention signal. The I/O 
supervisor then passes control to the con- 
sole interruption routine which issues a 
POST macro instruction. The POST routine 
posts the attention ECB and sets the com- 
munications task RB to a non-wait condi- 
tion. Because the communications task is 
of higher priority than the task in parti- 
tion 0, the POST routine places the address 
of the communications task TCB in location 
NEW. Control then passes to the 
dispatcher. 
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The dispatcher gives control to the com- 
munications task which passes control to 
resident device-support routines or issues 
SVC 72 for transient device-support 
routines. The device -support routines read 
the console's command and then xssue SVC 34 
to process the command, SVC 34 processes 
some commands completely but must pass con- 
trol to the master scheduler resident com- 
mand processor routine to complete proces- 
sing the DEFINE command. (See "Command 
Processing" in the Job Management section 
for a complete description of SVC 34 and 
the master scheduler task.) SVC 34 issues 
a POST macro instruction to post the master 
scheduler task. The POST routine sets the 
master scheduler RB to a non-wait condition 
and gives control to the dispatcher. 
Because the master scheduler task is of 
lower priority than the communications 
task, locations NEW and OLD remain 
unchanged and the dispatcher returns con- 
trol to the communications task. 

The communications task issues a WAIT 
macro instruction and waits on an ECB. The 
WAIT routine sets the communications task 
RB in a wait state and sets location NEW to 
zero. The dispatcher then receives control 
and searches the TCB queue. Since the 
master scheduler task is the next ready 
task on the TCB queue, the address of the 
master scheduler TCB is placed in locations 
NEW and OLD, and the dispatcher passes con- 
trol to the master scheduler. 



task P2 attempts to enqueue a resource 
through use of the ENQ macro instruc- 
tion, an interruption occurs and con- 
trol passes to the ENQ routine. 



C. The resource is unavailable because 
task PO has already enqueued it. 
Therefore, task P2 cannot continue 
executing. The enqueue routine places 
zero in location NEW and then passes 
control to the dispatcher which 
searches the TCB queue. Since task P2 
is the last task on the queue, the 
dispatcher sets the wait bit in the 
resume PSW of task P2. The dispatcher 
passes control to task P2 , placing the 
CPU in a machine wait condition. 



D. While the CPU is waiting, an interrup- 
tion occurs signifying the completion 
of the event for which task PO was 
waiting. The POST routine receives 
control and posts the ECB for task PO 
which is now able to- resume control. 
The POST routine places the TCB 
address for task PO in location NEW 
and gives control to the dispatcher. 
The dispatcher sets OLD equal to NEW 
and gives control to task PO. Task PO 
executes and when finished using the 
resource it has enqueued, it issues a 
DEQ macro instruction. 



The master scheduler completes proces- 
sing the DEFINE command and then issues 
WAIT. The WAIT routine sets location NEW 
to zero and passes control to the dispatch- 
er which searches the TCB queue until it 
finds a task ready to receive control. In 
Figure 8, control returns to the task which 
was executing before the operator entered 
the DEFINE command. 

Dispatching Tasks by Partition Priority 

Figure 9 illustrates task switching among 
tasks executing in partitions. 

A. The task in partition PO (task PO) is 
the highest-priority ready task and is 
given control by the dispatcher. When 
task PO issues a WAIT on an ECB, an 
interruption occurs and control passes 
to the WAIT routine. 

B. The WAIT routine places the RB for 
partition in a wait condition and 
sets location NEW to zero. It then 
passes control to the dispatcher which 
searches the TCB queue beginning with 
the TCB for partition 0. Since task 
PO is waiting and task PI is non- 
dispatchable, the dispatcher passes 
control to task P2, the highest 
priority task ready to execute. When 



E. An interruption occurs and the DEQ 
routine receives control. The queue 
element for task PO is removed from 
the resource queue. The next element 
on the resource queue is for task P2. 
The resource is assigned to task P2 
and its RB is placed in a non-wait 
condition. The DEQ routine then com- 
pares the priority of the task which 
has been in control with the priority 
of the task which is now ready. 
Because task PO has a higher priority 
than task P2, location NEW remains 
unchanged. The DEQ routine passes 
control to the dispatcher which 
returns control to task PO. 



Dispatching a Task (with Time Slicing) 

If time slicing was selected as a system 
generation option, the user can select a 
number of contiguous partitions to be a 
time-slice group. The tasks executing in 
time- sliced partitions have equal priority. 
Each ready task in the time -slice group 
executes for a selected amount of time, the 
time- slice length, and then loses control 
to the next ready task in the time -slice 
group. The time-slice group is supervised 
through use of a time- slice control element 
(TSCE) shown following. 
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FIRST - Address of the fist time-slice TCB on the TCB queue 


4 


LAST -Address of the last time-slice TCB on the TCB queue 


4 


NEXT - Address of the next time-slice TCB to be dispatched 


4 


LENGTH - Time-slice length ( in milliseconds ) 


4 



When time-slicing is selected, the dis- 
patcher performs functions in addition to 
those explained in the preceding para- 
graphs. The following text describes the 
additional dispatcher functions, and paral- 
lels the flow of data shown in Chart 02. 



NEW EQUALS OLD : The dispatcher first 
determines if NEW equals OLD. If it does, 
the dispatcher further determines if the 
task represented by OLD is a time-slice 
task. 

OLD a Time-Slice Task : If OLD is a time- 
slice task, the dispatcher determines if 
the time- si ice interval has expired; i.e., 
if the time- si ice queue element (TQE) has 
been removed from the timer queue. 

If the interval has expired, the next 
ready time- si ice task must be dispatched. 
The dispatcher searches the time-slice 
group beginning with the TCE addressed by 
TSCE NEXT (see preceding explanation of 
TSCE fields). When the TCE addressed by 
TSCE LAST is reached, the dispatcher checks 
the TCB addressed by TSCE FIRST, until a 
ready task is found or until all time-slice 
TCBs have been checked. 

When a ready task is found, TSCE NEXT is 
updated, the time-slice TQE is enqueued, 
and the ready task is dispatched. If no 
time-slice tasks are ready, the dispatcher 
searches the TCB queue for the highest- 
priority ready task. 

If the interval has not expired, i.e., 
the time- slice TQE has not been dequeued, 
control is returned to the interrupted 
task. 

OLD Not a Time-Slice Task : If OLD is not a 
time- si ice task, control is returned to the 
interrupted task . 



NEW NOT EQUAL TO OLD : If NEW does not 
equal OLD, the dispatcher determines if OLD 
is a time- si ice task. 



O LD Time- Slice Task — NEW Equal Zero : If 
OLD is a time- si ice task and NEW equals 
zero, the time-slice TQE is dequeued for 
the current task. The dispatcher then 
searches (using the TSCE) for the next 
ready TCB in the time- slice group. If no 
time- slice TCBs are ready, the dispatcher 
searches the TCB queue for the highest- 
priority ready task. 

OLD Time- Slice yask — NEW Not Equal to 
Zero : If OLD is a time- slice task and NEW 
does not equal zero, the dispatcher deter- 
mines if NEW is a time-slice task. 

If NEW is a time-slice task, the task 
represented by OLD, if ready, is redis- 
patched. (The time- slice TQE remains on 
the queue.) If the task represented by OLD 
is not ready, the time-slice TQE is 
dequeued, and the dispatcher searches 
(using the TSCE) for the next ready time- 
slice task. If no time-slice tasks are 
ready, the dispatcher searches the TCB 
queue for the highest-priority ready task. 

If NEW is not a time- slice task, the 
time-slice TQE is dequeued and the NEW task 
is dispatched. 

OLD Not a Time- SI ice Task : If OLD is not a 
time- slice task, the dispatcher finds the 
next highest-priority ready task. It does 
this by either obtaining the TCB address 
from NEW or, if NEW is zero, by scanning 
the TCB queue. If the highest-priority 
ready task is not a time-slice task, it is 
dispatched. If the highest-priority ready 
task is a time-slice task, the dispatcher 
finds (using the TSCE) the next ready task 
in the time- si ice group. The time -slice 
TQE is enqueued, and the task is 
dispatched. 



STAE SERVICE ROUTINE 

The STAE service routine is a type 3 SVC 
routine which prepares the task to inter- 
cept scheduled abnormal termination (ABEND) 
processing. When the STAE macro instruc- 
tion (resulting in an SVC 60) is issued, 
the STAE service routine is invoked. The 
STAE service routine creates a 16-byte STAE 
control block (SCB), which contains the 
addresses of a user-written STAE exit rou- 
tine and parameter list. When the task 
becomes scheduled for abnormal termination, 
the ABEND/STAE interface routine (ASIR) is 
given control by the ABEND routine. ASIR 
returns control to the user at the STAE 
exit routine address. After the STAE exit 
routine has been executed, control is 
returned to ASIR. ABEND processing con- 
tinues for the task as previously scheduled 
unless the STAE exit routine has requested 
that a STAE retry routine be scheduled. If 
a STAE retry routine is provided by the 
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user, ASIR reestablishes the task scheduled 
for ABEND processing and exits , giving con- 
trol to the dispatcher so that the STAE 
retry routine is executed next . See IBM 
System/360 Operating System: System Pro- 
grammer's Guide , Form C28-6550, for further 
explanation of the STAE macro instruction. 

The five modules which perform the func- 
tions of the STAE macro instruction are the 
STAE service routine (IGC00060) and the 
four ABEND/STAE interface modules 
(IGC0B01C, IGC0C01C, IGC0D01C f and IGC- 
0E01C) . These modules perform the same 
functions as in MVT, (see IBM System/ 360 
Operating System: MVT Supervisor , Form 
Y28-6659) with the exception both IGC0C01C 
and IGC0E01C pass control via the XCTL 
macro instruction to the AEEND module IEAG- 
TMOA to purge the WTOR queue before giving 
control to the next ASIR module (IGC0D01C). 



IEAGTM06, and DAR modules IEAGTM08 and 
IEAGTM09 exist only in MFT and are 
described below. The remaining modules are 
also used in PCP and are explained in IBM 
System/360 Operating System: Fixed Task 
S upervisor , Form Y28-6612. (For a brief 
description of all ABEND modules used in 
MFT, see " MODULE DESCRIPTIONS ," IN Appendix 
B of this publication.) 



ABEND STAE Test Routine (IEAGTMOA) 

IEAGTMOA first sets a bit to prohibit asyn- 
chronous exits for this task and tests the 
TCB for evidence of invalid recursion. If 
a primary DAR recursion or an invalid ABEND 
recursion is found, control is passed to 
DAR module IEAGTM08. If a secondary DAR 
recursion is found, control is passed to 
DAR module IEAGTM09. 



ABEND AND DAMAGE ASSESSMENT SERVICE ROUTINE 

ABEND is a type 4 SVC routine that is used 
for both normal and abnormal task termina- 
tion. ABEND terminates the task under 
which it is running, resets the partition, 
and passes control to the job management 
routines for continued processing. 

ABEND can be entered directly from the 
problem program or system task via an ABEND 
macro instruction, or indirectly through 
the ABTERM service routine. (ABTERM sched- 
ules the execution of ABEND for system rou- 
tines that detect an error but cannot issue 
an ABEND macro instruction.) The SVC SLIH 
(second level interruption handler) fetches 
the first load module of AEEND and passes 
control to it. Control is passed from one 
ABEND load module to the next via an XCTL 
instruction (SVC 7). The flow of control 
between modules for normal and abnormal 
termination is shown in Charts 03 and 04. 



The Damage Assessment Routines (DAR) 
process, and attempt to recover from the 
following failures: 

• System tasks (log, communication, or 
master scheduler). 

• Tasks in "must complete" status. 

• Tasks experiencing invalid ABEND 
recursion. 

A record of the failures is provided in a 
core image dump. A primary DAR recursion 
results when a failure occurs while writing 
the main storage image dump. A secondary 
DAR recursion results when a failure occurs 
during partition recovery. 

The ABEND and DAR functions provided for 
MFT are similar to those provided for PCP. 
ABEND modules IEAGTMOA, IEAGTM00, IEAGTM05, 



The routine then tests for normal end of 
task. If this is a normal end , the normal 
completion code is stored in the TCB, and 
control passes to ABEND module IEAGTM00. 
If the task is abnormally terminating , IEA- 
GTMOA determines if STAE (specify task 
asynchronous exit) processing is indicated 
for this task (via a user-issued STAE macro 
instruction) . 

If a STAE was issued , i.e., TCB field 
TCBNSTAE does not equal zero, IEAGTMOA 
checks for a valid STAE and performs as 
follows: 

• If the ABEND was issued by the Purge 
routine during STAE processing , i.e., 
the purge bit in TCB field TCBNSTAE 
equals one, the resume PSW of the Purge 
RB routine is set to the address of an 
EXIT instruction (SVC 3). IEAGTMOA 
then issues an EXIT instruction. 

Note : If ABEND was not entered from 
the Purge routine, i.e., the purge bit 
in TCB field TCBNSTAE equals zero, IEA- 
GTMOA stores the abnormal completion 
code in the TCB. 

• If "the Task is being abnormally ter- 
minated because of a timer expiration 
or an operator cancel , STAE processing 
is bypassed and IEAGTMOA exits to ABEND 
module IEAGTM00. (Since task timing 
and cancelations from the console are 
directly controlled by the user, the 
ABEND was intentional and should not be 
handled by the STAE routines.) 

• If STAE processing is already in pro- 
gress , regular ABEND processing con- 
tinues, since the STAE routine can pro- 
cess only once per STAE issued. IEAGT- 
MOA thus exits to ABEND module 
IEAGTM00. 
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• If this is a valid request for STAE 
processing , i.e., none of the above 
conditions are true, IEAGTMOA tests TCB 
field TCEPIE for zero. If it is not 
zero, IEAGTMOA frees the PIE and zeros 
TCBPIE. Thus, subsequent program 
checks will not be handled by a user 
routine which may not be designed for 
such a program check. IEAGTMOA then 
exits to STAE module IEAATMOB. 

If a STAE has not been issued, or if all 
STAEs have been processed , i.e., TCB field 
TCBNSTAE equals zero, IEAGTMOA determines 
if this is a graphics or an ABEND recursion 
and if this is a graphics job with a Graph- 
ics Abend Exit routine. 

• If this is a recurs ion , or if the task 
abnormally terminating is not a graph- 
ics job , IEAGTMOA exits to ABEND module 
IEAGTMOO. 

• If this is a graphics job , IEAGTMOA 
passes control to the Graphics Abend 
routine. At the completion of this 
routine, control is returned either to 
the caller via an SVC 3 (if the task is 
resumable, i.e., the ABEND was issued 
by a user program or caused by a pro- 
gram check in a user routine, and if he 
wishes to resume processing) or to IEA- 
GTMOA, which exits to AEEND module 
IEAGTM00. 

ABEND Initialization Routine (IEAGTMOO) 

This routine prepares for ABEND processing 
of a task by canceling the task timer ele- 
ment and by dequeuing all interruption 
queue elements (IQEs) belonging to the 
task. If the routine was entered from 
STAE, it also purges the WTOR queue ele- 
ments for the task and passes control to 
IEAATM0D. If the routine was entered as 
the result of a normal end of task, it 
passes control to IEAGTMOS. If it was 
entered as the result of an abnormal end of 
task, it passes control to IEAGTM06. 

ABEND Input/Cutput Purge Routine (IEAGTMQ6) 

IEAGTM06 purges I/O requests and I/O opera- 
tions via a macro instruction version of 
the SVC Purge Routine, which is assembled 
within this module. (See "SVC PURGE ROU- 
TINE" in Input/Output Supervisor , Form Y28- 
6616 . ) This prevents errors that can cause 
recursion to the ABEND routine. (Since 
ABEND frees main storage, an I/O operation 
that is not halted can cause information to 
be read into, or an ECB to be posted in 
main storage that may have been relocated, 
thus destroying data or programs.) RQEs 
(request queue elements) removed from the 
request queue are returned to a list of 
available RQEs for reuse by the I/O 
supervisor. 



IEAGTM06 also dequeues, from the SIRB 
(system interruption request block), IQEs 
(interruption queue elements) representing 
requests for the use of I/O error handling 
routines. The routine passes control to 
DAR module IEAGTM08 when Recovery Manage- 
ment Support is not the caller, and the 
failing task is a task in "Must Complete" 
status or if the failing task is a system 
task. Otherwise IEAGTM06 passes control to 
AEEND module IEAATM01. 



AEEND Termination Routine (IEAGTM05) 



ABEND termination routine IEAGTM05 is the 
final ABEND module for both normal and 
abnormal termination. For normal termina- 
tion it is entered from IEAGTM06. On 
abnormal termination it may have been 
entered from any of the previous modules of 
ABEND except initialization routine 
IEAGTMOO. 



If a dump message is required, i.e., if 
AEDUMP has been initiated but has failed to 
complete, IEAGTM05 causes message IEA002I, 
"ABEND/ABDUMP ERROR" to be printed. 
IEAGTM05 issues a CLOSE macro instruction 
for any open data sets. The timer queue 
and the main storage supervisor queue are 
purged, and fields in the TCB are reset so 
that a new task may be initiated. If an 
indicative dump is provided by IEAATM03 , it 
is moved to the upper boundary of the 
partition. 

IEAGTM05 does not directly transfer con- 
trol to a job management routine. In the 
first 72 bytes of the problem program par- 
tition, IEAGTM05 establishes a dummy PRB, 
an XCTL parameter list, and a set of 
instructions including an XCTL to a step 
deletion routine. The XRBLNK field of the 
dummy PRB contains a pointer to the TCB. 
The dummy PRB therefore becomes the only RB 
queued for this task. 

The dummy PRB is then placed at the 
beginning of the RB queue. This ensures 
that the XCTL instruction will be the next 
operation executed for this task after 
IEAGTM05 has completed. For scheduler-size 
partitions, step deletion routine IEFSD515 
gains control, at entry point GO. For 
small partitions, control is passed to 
entry point SMALLGO in small partition rou- 
tine IEFSD599. 



DAMAGE ASSESSMENT ROUTINES 

The damage assessment routines are used to 
eliminate wait states due to system fail- 
ures. When a system failure occurs, the 
damage assessment routines provide an image 
of main storage at the time of failure and 
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reinitialize the failing task. The rou- 
tines also advise the operator of the fail- 
ure and subsequent reinstatement of the 
task. 

There are two routines that are unique 
to MFT: Damage assessment core image dump 
routine IEAGTM08, and damage assessment 
task reinstatement routine IEAGTM09. 

PAR Core Image Dump Routine (IEAGTM08) 

The DAR core image dump routine IEAGTM08 
writes on the SYS1.DUMP data set an image 
of main storage at the time of failure. 
When entered, the routine sets all tasks 
except the failing task and the communica- 
tions task nondispatchable. The routine 
then writes the image of main storage and 
passes control to the DAR task reinstate- 
ment routine IEAGTM09. 

If the SYS1.DUMP data set has not been 
allocated, the routine informs the operator 
via a WTO. If the routine is entered as a 
result of a primary DAR recursion, which is 
caused by a failure to write the image of 
main storage, the routine does not try to 
rewrite but informs the operator of the 
failure via a WTO. In both cases the rou- 
tine passes control to IEAGTM09. 

If the communications task is the fail- 
ing task, messages are queued pending rein- 
statement of the communications task by 
IEAGTM09. 

DAR Task Reinstatement Routine (IEAGTM09) 

If the DAR task reinstatement routine 
IEAGTM09 is entered as a result of a fail- 
ing system task, the routine attempts to 
reinstate the task. It points the resume 
PSWs of all but the highest level RB of the 
task's TCB to an SVC 3 instruction in the 
CVT. It points the highest level RB to 
entry point IEECIR50 for the Master Sched- 
uler task, entry point IEECIR45 for the 
Communications task, or entry point IEEVLIN 
for the Log task. The routine then passes 
control to the dispatcher via a branch 
instruction. 

If the routine is entered as a result of 
a secondary DAR recursion, which is caused 
by a failure to reinstate the failing task, 
the routine informs the operator via a WTO, 
sets all tasks dispatchable except the 
failing task, and passes control to the 
dispatcher via a branch instruction. 

If the failing task is in "Must Com- 
plete" status, the task reinstatement rou- 
tine issues a message to the operator list- 
ing the major and minor names of the 
enqueued resources that have caused the 
•Must Complete" condition and asking the 
operator to reply whether the resources are 



critical. If the reply indicates the 
resources are critical , processing is 
identical to the processing of a secondary 
DAR recursion described above. If the re- 
ply indicates the resources are not critic- 
al, the "Must Complete" status is removed, 
and the resources are designated as share- 
able. The task is processed as a failing 
non- system task as described below. 

If the routine is entered as a result of 
a failing non- system task, it sets indica- 
tors showing that a dump has been taken by 
DAR and issues a message to the operator 
indicating that the system has been rein- 
stated. The routine then sets all tasks 
dispatchable and passes control to 
IEAGTM05. 



Task Supervision 

The task supervisor maintains the status of 
tasks within the system. Task supervision 
service routines: 

• Maintain task control blocks. 

• Enter tasks into the wait state. 

• Post completed events in the event con- 
trol block (ECB). 

• Maintain control levels indicated by 
request blocks. 

The routines which accomplish these 
functions are WAIT, POST, ENQ, and DEQ. 

Each task within the operating system 
has an associated task control block (TCB) . 
The TCB contains task-related information 
and pointers to additional control blocks 
containing task-related information. The 
control blocks used by MFT are the same as 
those used by PCP except for the addition 
of the partition information block (PIB) 
which is described in Appendix A. The last 
three bytes of the word at displacement 124 
(decimal) of each partition TCB contain the 
address of the associated PIB. Figure 10 
shows the major control blocks maintained 
by the supervisor and their relationship to 
the TCB. 

Task supervision is described in IBM 
System/360 Operating System: Fixed-Task 
Supervisor , Program Logic Manual , Form Y28- 
6612. Additional information applicable to 
MFT is presented in the following 
paragraphs. 



THE ATTACH ROUTINE (MACRO IEAAAT) 

In MFT, the ATTACH and LINK macro instruc- 
tions are handled identically. An RB is 
created for the requested program, the pro- 
gram is brought into the requesting task's 
partition, and its RB is chained to the RB 
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Figure 10. System Control Block Relationship 



queue for that partition. See IBM System/ 
360 Operating System; Supervisor and Data 
Management Services , Form C28-6646 for 
further explanation of the ATTACH macro 
instruction with MFT. 



Because of point 2, it is not possible for 
one partition to WAIT on an ECB within 
another partition. 



THE POST ROUTINE (MACRO IEAAPT) 



THE WAIT ROUTINE (MACRO IEAAWT) 

The WAIT routine is not changed from that 
described in Fixed-Task Supervisor, Program 
Logic Manual . However, the user should 
remember the effect the optional validity 
checking feature has on WAIT. If validity 
check is included in the system and the 
program issuing the WAIT macro instruction 
is not in supervisor mode, the WAIT routine 
checks that: 

1. The boundary alignment of the ECEs is 
correct. 

2 . The storage protection key of the ECBs 
is that of the issuing program. 

3. The addresses specif ied do not exceed 
main storage boundaries of the 
machine. 



The POST routine, like the WAIT routine, is 
unchanged from that described in Fixed- 
T ask Supervisor, Program Logic Manual . 
Validity checking applies to POST in the 
same way it applies to WAIT. 



THE ENQ/DEQ ROUTINE (IEAGENQl) 

The ENQ/DEQ routine provides a means of 
controlling serially reusable resources. 
This is done by assigning unique names con- 
sisting of a Qname and an Rname to each 
serially reusable resource. The ENQ/DEQ 
routine controls access to resources by 
building resource queues consisting of a 
queue control block (QCB) for each Qname 
and Rname specified in an ENQ macro 
instruction and a queue element (QEL) to 
represent each actual request. ENQ/DEQ is 
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fully described in IBM System/ 360 Operating 
System; MVT Supervisor , Program Logic 
Manual , Form Y28-6659. ENQ/DEQ for MFT is 
identical to MVT except as described below. 

In MFT, resource queues are located in 
the system queue area (subpool 255). Loca- 
tion IEACQCBO in the ENQ/DEQ routine con- 
tains the address of the first queue con- 
trol block in the queue. There is only one 
TCB for each job step in MFT. Therefore , 
the "must complete" function of ENQ/DEQ 
applies only to the system, not to job 
steps. If "system must complete" is speci- 
fied by a task, all other tasks in the sys- 
tem are set non-dispatchable until the task 
which specified "system must complete" com- 
pletes its processing. 



Contents Supervision 

Contents supervision routines determine the 
location of requested programs and fetch 
them into main storage if necessary. They 
also maintain records of all programs in 
main storage. Programs requested via LINK 
or XCTL macro instructions are scheduled 
for use by placing a request block (RB) for 
each program on the requesting task's 
active request block queue. 



Programs requested via LOAD macro 
instructions are represented by RBs on the 
loaded program list. 



There are six types of request blocks in 

MFT: 

• Program Request Block (PRB) — repre- 
sents a nonsupervisory routine that 
must be executed in the performance of 
a task. PRBs are created by the con- 
tents supervision routines that perform 
the LINK or XCTL functions. 

• Supervisor Request Block (SVRB) — 
represents a supervisory routine. 
SVRBs are created by the SVC interrup- 
tion handling routines. 

• Interruption Request Elock (IRB) — 
controls a routine that must be 
executed in the event of an asynch- 
ronous interruption. IREs are created 
in advance of an interruption by the 
CIRB routine at the user's request, but 
not placed on an RB queue until an 
interruption actually occurs. 

• System Interruption Request Block 
(SIRB) — used only for the system I/O 
error task. There is only one SIRB in 
the system. 



• Loaded Program Request Block (IPRE) — 
controls programs brought in by a LOAD 
macro instruction. LPRBs also control 
sections of programs that are specified 
by the IDENTIFY macro instruction. 
LPRBs are created by the contents 
supervision routines that perform the 
LOAD function. 

• Loaded Request Block (LRB) — a shor- 
tened form of LPRB and controls load 
modules that have the "load only" at- 
tribute. It is invalid to issue 
ATTACH, LINK, or XCTL macro instruc- 
tions to these load modules. LRBs are 
created by the routines that perform 
the LOAD function. 

Contents supervision routines alter the 
active RB queue and the loaded program 
list, and bring nonresident programs into 
the problem program partitions in response 
to LINK, ATTACH, LOAD, and XCTL macro 
instructions. Additional contents supervi- 
sion services are provided by the use of 
IDENTIFY, DELETE , and SYNCH macro instruc- 
tions. IDENTIFY and DELETE alter the 
loaded program list. SYNCH alters the 
active request block queue. The routines 
that service these macro instructions are 
described below. 



LINK SERVICE ROUTINE (MACRO IEAATC) 

The LINK service routine determines if the 
RB of the requested routine is on the 
loaded program list. If it is and is inac- 
tive, LINK places the RB on the active RB 
queue. If the requested RB is not on the 
loaded program list (or if it is on the 
list, but is active) , and the resident re- 
enterable routine option was selected at 
system generation, the routine searches the 
resident area. If the module is found in 
the area, a load list element for the 
module is placed on the loaded program 
list, and processing continues as if the 
module were originally found on the load 
list. If the module is not found, the LINK 
routine constructs an RB for the requested 
routine, places the RB on the active RB 
queue, and fetches the requested routine 
into main storage. 



ATTACH SERVICE ROUTINE (MACRO IEAAAT) 

The ATTACH macro instruction is handled as 
a LINK macro instruction. For a complete 
explanation, see "The ATTACH Macro Instruc- 
tion" under the topic Task Supervision. 



LOAD SERVICE ROUTINE (MACRO IEAATC) 

The LOAD service routine first determines 
if the requested routine is in the resident 



Supervisor 33 



I reenterable routine area (if the resident 
routine option was specified at system 
generation). If so, the entry point of the 
routine is passed to the requesting routine 

I in register zero. If the routine is not 
resident, LOAD searches the loaded program 
list for the RB of the requested routine. 
If it is found, the LOAD routine increments 
the RB use count by one and returns the 
entry point of the requested routine in 
register zero. 

If the requested routine is not found on 
the loaded program list, the LOAD routine 
tranches to the FINCH routine to load the 
requested routine into storage. On return 
from the FINCH routine, the LOAD routine 
initializes the requested routine is RB and 
places it on the loaded program list, sets 
the RBs use count to one and branches to 
the LINK routine to issue the SVC EXIT 
instruction. 



list element for the module is placed on 
the loaded program list, and processing 
continues as if the module were originally 
found on the load list. If the module is 
not found, the XCTL routine branches to the 
FINCH routine to bring in the routine. On 
return from the FINCH routine, the XCTL 
routine branches to the LINK routine to 
place the RB on the active queue and issue 
an SVC EXIT instruction. 

IDENTIFY SERVICE ROUTINE (IEAAIDOO) 

The IDENTIFY service routine builds and 
initializes a minor request block to 
describe a routine specified in the parame- 
ters of the IDENTIFY macro instruction. 
The IDENTIFY routine chains this minor RB 
to the loaded program list and to the RB of 
the routine which contains the identified 
routine. The IDENTIFY routine returns to 
the issuer by issuing an SVC EXIT 
instruction. 



XCTL SERVICE ROUTINE (MACRO IEAATC) 

The XCTL service routine first determines 
if XCTL was issued by a transient SVC rou- 
tine. It then determines if the resident 
SVC (RSVC) option was chosen at system 
generation and determines if the requested 
SVC routine is an RSVC routine. If it is, 
the routine need not be brought into main 
storage. If the requested routine is not 
an RSVC, the XCTL routine branches to the 
FINCH routine to locate the routine on the 
SVC library and to bring it into the SVC 
transient area. The XCTL routine initia- 
lizes the routine* s RB and executes an SVC 
EXIT instruction. 

If the XCTL macro instruction was not 
issued by a transient SVC routine, the XCTL 
routine dequeues the primary RB and each 
minor RB of the issuer from the active RB 
queue. The routine which issued the XCTL 
macro instruction and its RB are removed 
from storage unless the routine was brought 
in via a LOAD macro instruction. If the 
requested routine is on the loaded program 
list and is inactive, the XCTL routine 
branches to the LINK routine to place the 
RB on the active queue and to issue an SVC 
EXIT instruction . 

If the XCTL routine determines that the 
scheduler has issued an XCTL macro instruc- 
tion to branch to the problem program, the 
XCTL routine zeros out the TCBTCT field of 
the TCB so that the optional Job/Step CPU 
Timing entry can be made. 

If the RB of the requested routine was 
not found inactive on the loaded program 
list, and the resident reenterable module 
option was selected at system generation, 
the routine searches the resident area. If 
the module is found in the area, a lead 



DELETE SERVICE ROUTINE (IEAADLOO, IEAEDLOO) 

The DELETE service routine determines if 
the routine specified in the DELETE macro 
instruction is resident. If it is, the 
DELETE routine exits immediately. If the 
routine is not resident, the DELETE routine 
finds the routine's RB on the loaded pro- 
gram list and decrements the use count in 
the RB by one. If the use count reaches 
zero, the DELETE routine dequeues the rou- 
tine from the loaded program list and 
issues a FREEMAIN macro instruction to 
release the storage occupied by the speci- 
fied routine and its RB. On return from 
the FREEMAIN routine, the DELETE routine 
repeats the deleting process for each minor 
RB belonging to the specified routine. The 
DELETE routine returns by branching to the 
type 1 SVC exit. 

SYNCH SERVICE ROUTINE (IEAASYOO) 

The SYNCH service routine uses GETNAIN to 
obtain 32 bytes of main storage from the 
lower end of the partition for the creation 
of a program request block (FRB) . The PSW 
in the PRB is initialized by the SYNCH rou- 
tine to address the location specified in 
register 15 by the issuer of the macro 
instruction. The SYNCH routine sets the 
PSft completely enabled in problem program 
mode, with the protection key recorded in 
the task control block. After the PRB is 
created and initialized, the SYNCH routine 
queues it on the active request block queue 
below the SVRB for SYNCH, and returns by 
issuing an SVC EXIT instruction. 

Additional information describing PCP 
and MFT Contents Supervision can be found 
in Fixed-Task Supervisor, Program Logic 
Manual. 



34 



Main Storage Supervision 



In MFT, the main storage supervisor: 

1. Allocates space via the GETMAIN SVC. 

2. Deallocates space via the FREEMAIN 
SVC. 

3. Allocates space in the system queue 
area. 

4. Checks validity of requests that are 
to be serviced. 

5. Maintains the pointers and control 
blocks necessary to supervise main 
storage. 



Each job is assigned to a partition in 
which it must operate. Each partition has 
an associated TCB which contains a pointer 
(TCBMSS field) to the main storage boundary 
box for that partition. The main storage 
supervisor, in response to GETMAIN macro 
instructions, obtains storage from either 
the problem program partition or the system 
queue area. Obtaining storage space from 
the system queue area is the basic dif- 
ference in main storage supervision between 
MFT and PCP. In MFT, a system task can 
issue a GETMAIN macro instruction specify- 
ing subpool 255 and the required storage 
will be allocated from the system queue 
area. The system queue area is used to 
obtain space for system control blocks 
which might be destroyed by problem pro- 
grams if they were placed in problem pro- 
gram partitions. The system tasks which 
request storage space from subpool 255 are: 

• The CSCB creation module of SVC 34, for 
CSCBs. 

• The ENQ/DEQ processing routines of task 
supervision, for all control blocks 
associated with ENQ/DEQ. 

• The communications task, for write-to- 
operator (WTO) buffers if all WTO buff- 
er storage space specified during sys- 
tem generation is unavailable. 



Note : Although subpools are not created in 
MFT (as in PCP and MVT), problem programs 
and system tasks may specify subpools in 
the GETMAIN macro instruction. However, 
all main storage requests from problem pro- 
grams are allocated from the highest avail- 
able main storage in the partition which 
issued the GETMAIN. 

The boundary box for the system queue 
area is located in master scheduler resi- 
dent data area IEESD568 (see Appendix A). 
The master scheduler resident data area is 
addressed by the CVTMSER field in the Com- 
munications Vector Table. 



When problem programs issue GETMAIN 
macro instructions specifying a subpool 
from through 127, storage is allocated 
from the high-address portion of the parti- 
tion in which the GETMAIN macro instruction 
was issued. When problem programs attempt 
to issue a GETMAIN macro instruction speci- 
fying a subpool from 128 through 255, the 
program is abnormally terminated. 

When system tasks issue a GETMAIN macro 
instruction specifying a subpool from 
through 127, storage is allocated from the 
low- address portion of the partition; when 
specifying a subpool from 128 through 254, 
storage is allocated from the high-address 
portion of the partition. Subpool 255 is 
handled as a special case as described in 
preceding paragraphs. 

For a complete description of main 
storage supervisor functions, see Fixed - 
Task Supervisor , Program Logic Manual . 



TIMER SUPERVISION 

Timer supervision routines are an optional 
feature of MFT. If selected, the user may 
request timer services through the TIME, 
STIMER, and TTIMER macro instructions. The 
TIME service routine (IEA0RT00) determines 
the date and time of day. The STIMER ser- 
vice routine (IEA0ST00) sets a user speci- 
fied interval, and the TTIMER service rou- 
tine (IEAOSTOO) determines the amount of 
time remaining in a previously specified 
interval. Whenever a timer interval is 
requested in an STIMER macro instruction, a 
timer queue element (TQE) is constructed. 
These elements are chained together in a 
timer queue. The queue is ordered so that 
the TQE representing the next interval to 
expire is always at the top of the queue. 
When a requested interval expires, a timer 
interruption occurs and the Supervisor 
Timer Interruption Handling Routine (IEAO- 
TIOO) takes appropriate action, depending 
on the type of interval which has expired. 
If job/step CPU timing is included in the 
system, IEA0TI00 adjusts the pseudo timer 
field in IEATPC in the same manner it 
adjusts the hardware timer. 



Timer Supervision 

The System/360 interval timer is a 32 bit 
word in lower main storage which continual- 
ly decrements as long as the system is run- 
ning and the interval timer switch is on. 
The timer supervision routines use this 
hardware timer to accomplish their func- 
tions. The timer supervision routines can 
set the hardware timer to any interval 
between zero and six hours. An interrup- 
tion occurs when the hardware timer decre- 
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ments to zero. Since the hardware timer 
never exceeds six hours , four values are 
needed to maintain elapsed time for a full 
day. These values are: 

• Hardware timer. 

• Six Hour Fseudo Clock (SHPC). 

• Twenty- four Hour Pseudo Clock (T4PC) . 

• Local Time Pseudo Clock (LTPC) . 

The SHPC is used to time intervals up to 
six hours; the TUPC is used to time inter- 
vals up to twenty- four hours. The LTPC 
contains the local time of day entered by 
the operator during system initialization. 

When an STIMER macro instruction is 
issued, the STIMER supervisory routine 
adjusts the time interval requested rela- 
tive to the intervals in the hardware 
timers and pseudo clocks. This enables the 
supervisory routines to place the newly 
requested timer element in the correct 
place on the timer queue. 



TIMER PSEUDC CLOCK ROUTINE (IEATPC) 

The timer pseudo clock routine (IEATPC) 
contains all variable information that 
would normally be included in the resident 
timer routines. This information includes: 

• Pseudo clocks. 

• Work space used for incrementing CVT 
date. 

• Accumulator for the job/step CPU timing 
feature. 



COMPARISON OF PCP, MFT, AND MVT TIMER 
SUPERVISION 

Requests for timer services in PCP, MFT, 
and MVT are made using the same macro 
instructions. Timer requests are enqueued 
on the timer queue in the same way in all 
three systems. There is one difference 
between PCP and MFT timer supervision. 
Because there is only one partition in PCP, 
the timer completion exit routine receives 
control as soon as a requested task time 
interval expires. When a timer interval 
expires in MFT, the timer completion exit 
routine does not receive control until the 
task which requested the timer interval is 
the highest priority ready task in the sys- 
tem. In MVT, the maximum amount of time 
permitted to complete a job step or cata- 
loged procedure may be specified on the 
EXEC card. This facility is not provided 
in MFT. 

For a complete description of timer 
supervisor, see Fixed-Task Supervisor, Pro- 
gram Logic Manual , and MVT Supervisor Pro- 
gram Logic Manual . 



Overlay Supervision 



The routines which supervise loading of 
overlay program segments and assist flow of 
control between segments of the overlay 
program are identical in operation for PCP 
and MFT. A complete description of PCP and 
MFT overlay supervision can be found in 
F ixed-Task Supervisor, Program Logic 
Manual. 



MFT Recording/Recovery Routines 

Operating System Recording/Recovery rou- 
tines are optional control program routines 
which may be selected during system genera- 
tion. They handle two types of equipment 
malfunctions: 

• Malfunctions of the central processing 
unit (CPU), which cause machine-check 
interruptions . 

• Malfunctions in a channel, which cause 
input/output interruptions. 

Operating System Recording/Recovery rou- 
tines are divided into two groups: System 
Environment Recording and Recovery 
Management. 

System Environment Recording includes: 

• System Environment Recording (SERO, 
described in IBM System/360 Operating 
System: Fixed-Task Supervisor, Program 
Logic Manual , Form Y28-6612. 

• System Environment Recording 1 (SER1) , 
also described in the Fixed-Task Super- 
visor PLM. 

Recovery Management includes: 

• Machine-Check Handler (MCH) , described 
in IBM System/360 Operating System: 
Machine-Check Handler for IBM System/ 
360 Model 65, Program Logic Manual , 
Form Y27-7155. 

• Channel-Check Handler (CCH) , described 
in IBM System/360 Operating System: 
Input/output Supervisor, Program logic 
Manual, Form Y28-6616. 



MACHINE-CHECK ROUTINES 

There are three machine-check routines. 

The recording routines: 

SERO, which records information about 

the error and then places the sys- 
tem in a wait state. 
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SER1, which records information about 

the error and attempts to associ- 
ate the error with a task. If it 
can do this, it abnormally ter- 
minates the task and allows the 
system to continue operation. 

The recovery routine: 

MCH, which records information about 
the error and attempts complete 
recovery from it, including retry 
of the instruction that caused the 
error . 

For the Model 65, any one of these three 
routines may be selected during system 
generation. For the Model 40 f 50 f 75, and 
91, either SERO or SER1 may be selected. 
If no routine is selected, either SERO or 
SER1 is used by default. The version used 
by default depends on the model (or models) 
specified, and on the size of the system 
(see IBM System/360 Operating System; Sys- 
tem Generation , Form C28-6554) . 



CHANNEL- CHECK ROUTINE 

There is only one channel-check routine : 

CCH, which aids recovery from channel 
errors by: 

• Providing channel error information to 
IBM- supplied device dependent error 
recovery procedures (ERP). 

• Building a record entry which is later 
written on SYS1.LOGREC by the statisti- 
cal data recorder of the I/O 
supervisor . 

This routine may be selected during system 
generation for the Model 65, 75, and 91 
only . 

SYSTEMS WITHOUT RECORDING/RECOVERY ROUTINES 

A machine check or I/O interruption caused 
by an equipment malfunction places in a 
wait state those IBM System/360 models that 
do not have Recording/Recovery routines 
(See Figure 11). A message is issued on 
the console telling the operator to load 
the System Environment Recording, Editing, 
and Printing (SEREP) program. SEREP is a 
model- dependent, stand-alone diagnostic 
program. Its use is described in IBM 



I System/360 Operating System: Operator's 
G uide , Form C28-6540. 



ENTRY TO RECORDING /RECOVERY ROUTINES 

When a machine-check interruption occurs, 
the machine- check new PSW is loaded. This 
causes control to pass directly to the 
Recording/Recovery routine which was 
selected during system generation (see 
Figure 11) . 

When an I/O interruption occurs because 
of a channel error, the I/O new PSW is 
loaded. This causes control to pass to the 
I/O FLIH and then to the I/C Supervisor. 

If the Channel -Check Handler option was 
not selected during system generation, the 
I/O Supervisor enters the SER Interface 
subroutine (SERR04) within the I/O Supervi- 
sor. This routine loads the machine-check 
new PSW (See Figure 11). 

If the Channel-Check Handler was 
selected during system generation, the I/O 
Supervisor enters the Channel -check Handler 
Interface (SERR04) within the I/O Supervi- 
sor (see Figure 11). 



Checkpoint/Restart Routines 

The checkpoint/re start routines used by MFT 
allow a job to restart after an abnormal 
termination. The checkpoint routine (SVC 
63) is used by the programmer to create a 
record of the job f s main storage region at 
selected points during the execution of a 
job step. The routine is identical with 
the PCP checkpoint routine described in IBM 
System/360 Operating System; Fixed-Task 
Supervisor, Program Logic Manual , Form 
v.28-6612. 

The restart routine (SVC 52) allows jobs 
to restart at a checkpoint. If the restart 
is automatic, it will occur at the last 
valid checkpoint taken by the job before it 
abnormally terminated. If the restart is 
deferred, it will occur at the checkpoint 
specified by the job statement. Processing 
of the restarting job is discussed in the 
Job Processing section of this manual. The 
restart routine is described in IBM System/ 
3 60 Operating System; Fixed Task Supervi- 
sor, Program Logic Manual , Form Y28-6612. 
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A CPU Malfunction causes a 
Machine Check Interruption 



A Channel Malfunction causes an 
Input/ Output Interruption 



1 . Wait State 





Load Machine 
Check New PSW 



2. SERO Routine 



3. SER1 Routine 



System 
Generation 
Option 
(1,2,3, or 4) 



Input/Output 



Supervisor 



1. SEIV'MCH 
Interface 



System 
Generation 
Option 
or 2) 




4. Machine-Check 
Handler 



Figure 11. Recording/Recovery Routines 
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Job Management 



The primary job management function is to 
prepare job steps for execution and, when 
they have been executed, to direct the dis- 
position of data sets created during execu- 
tion. Prior to step execution, job 
management: 

• Reads control statements from the input 
job stream 

• Places information contained in the 
statements into a series of tables. 

• Analyzes input/output requirements. 

• Assigns input/output devices. 

• Passes control to the job step. 
Following step execution, job management: 

• Releases main storage space occupied by 
the tables. 

• Frees input/output devices assigned to 
the step. 

• Disposes of data sets referred to or 
created during execution. 

Job management also performs all proces- 
sing required for communication between an 
operator and the control program. Major 
components of job management are the job 
scheduler, which introduces each job step 
to the system (job processing), and the 
communications and master scheduler tasks, 
which handle all operator -system communica- 
tion (command processing). 

JOB SCHEDULER FUNCTIONS 

The job scheduler includes three programs: 
the reader/interpreter, the initiator/ 
terminator, and the system output writer. 
The functions of the reader/interpreter are 
similar to the MVT reader; additional 
information can be found in IBM System/ 3 60 
Operating System: MVT Job Management, Pro- 
gram Logic Manual , Form Y28-6660. 

After all control statements for a job 
have been processed, all initiators that 
are waiting for that job class are posted 
and the initiator residing in the highest 
priority partition is given control. The 
MFT initiator is described in the Job Man- 



agement section of this publication; for 
information on allocation and termination, 
refer to IBM System/360 Operating System: 



M VT Job Management, Program Logic Manual , 
Form ¥28-6660. 

When the job step has been executed, 
control is returned to the initiator/ 
terminator which performs data set disposi- 
tions and releases input/output (I/O 
resources. If the entire job is to be ter- 
minated, the terminator engueues all data 
sets on the appropriate system output (SYS- 
OUT) queues. 

When the system output writer receives 
control, it dequeues a job from an output 
queue, and transcribes the data sets to the 
user-specified output device. (See IBM 
System/360 Operating System: MVT Job Man- 
agement, Program Logic Manual , Form Y28- 
6660, for further information on the system 
output writer.) 



COMMUNICATIONS TASK FUNCTIONS 

The routines of the communications task 
process the following types of communica- 
tion between the operator and the system: 

• Operator commands, entered through a 
console. 

• Write- to-opera tor (WTC) and write-to- 
operator with reply (WTOR) macro in- 
structions. 

• Interruptions caused when the INTERRUPT 
key is pressed, to switch functions 
from the primary con sole /master console 
to its alternate console. 

• If the system has Multiple Console Sup- 
port, the communications task processes 
the delete operator message (DCM) macro 
instruction and provides buffer manage- 
ment for all console devices. 



MASTER SCHEDULER TASK FUNCTIONS 

The master scheduler task consists of SVC 
34 and the master scheduler resident com- 
mand processor routines. The SVC 34 com- 
mand scheduler routines process all com- 
mands initially. The job queue manipula- 
tion and partition definitions, which are 
not fully processed by SVC 34, are passed 
to the master scheduler resident command 
processor. Table 1 lists the commands used 
in MFT and indicates the routine which 
responds to the commands after initial 
processing. 
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Table 1. Responders to Commands After Initial Processing 

r T 

Command 



Responder 



-H 



CANCEL (active jobs) 



Initiator 



CANCEL (job in queue) 



Master Scheduler 



--H 



DEFINE 



Master Scheduler 



DISPLAY STATUS, JOENAMES, DSNAME 
DISPLAY A,Q,N, jobname, CONSOLES 



Initiator 
Master Scheduler 



DISPLAY R 



Master Scheduler 



DISPLAY SPACE 



I/O Device Allocation 



-H 



DISPLAY T 



Timer Maintenance Routine * 



HALT 



Statistics Update Routine * 



HOLD 



LOG 



Master Scheduler 



System Log 



MODE 



Master Scheduler 



MODIFY 



Writer 



MOUNT 



Master Scheduler 



RELEASE 



Master Scheduler 



REPLY 



Master Scheduler 



RESET 



Master Scheduler 



SET CLOCK, DATE 



Timer Maintenance Routine * 



SET PRCC, Q, AUTO 



Master Scheduler 






START/STOP Reader 



Reader /Interpreter 



START/STOP Writer 



Writer 



UNLOAD 



Initiator 



VARY 



Initiator 



1 



WRITELCG 



System Log* 



_ 1 



* See the publication IEM System/360 Operating System; MVT Supervisor , Program 
Logic Manual , Form Y28-6659. 



JOB MANAGEMENT CONTROL FLOW 

Figure 12 shows the major components of job 
management and the general flow of control. 

Control is passed to job management 
| whenever the supervisor finds that there 
are no program request blocks in the re- 
quest block queue. This can occur for two 
reasons: either the initial program load- 
ing (I PL) procedure has just been com- 



pleted, or a job step has just been 
executed. 

E ntry to Job Management Following Initial 
P rogram Loading 

Following IPL, certain actions must be 
taken by the operator before job processing 
can begin. Therefore, control passes to 
the communications task which issues a mes- 
sage to the operator instructing him to 
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SVC 34 
COMMAND 
SCHEDULING 
ROUTINES 



SVC 34 Commands 



DISK 



I TAPE V 



JCL, Commands, 
and Data 



CARD 
READER 



COMMAND 
EXECUTION 
ROUTINES 



RETURN TO 
CALLER OF 
SVC 34 



COMMAND PROCESSING 



See 
Table 1. 



READING 
TASKS 



Input Job 
Description 



WORK 
QUEUES 
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•Figure 12. Job Management Data Flow 



enter commands r or to redefine the system. 
If he chooses to redefine the system, con- 
trol passes to the master scheduler task to 
handle the redefinitions. If the system is 
not to be redefined, the initialization 
commands (a SET command, a START reader 
command, a START writer command, and a 
START INIT command) are issued (either 
automatically by the master scheduler task 
or by the operator performing the IPL), and 
job processing begins. 

Entry to Job Management Following Step 
Execution 

Following step execution, control is passed 
to the step termination routine of the 
initiator/terminator. If no further job 
steps are to be processed, control is also 



passed to the job termination routine of 
the initiator /terminator. Both routines 
are described in the topic 
"Initiator/Terminator . " 

MFT job management is similar in many 
respects to MVT job management. However, 
certain major differences in logic exist. 
These differences are described in two 
major topics. "Command Processing" 
includes the communications task and master 
scheduler task. "Job Processing" includes: 

• Queue Management. 

• Reader /Interpreter . 

• Initiator/Terminator. 

• System output writer. 

• System task control. 

• System restart. 
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References to IBM System/360 Operating 
System: MVT Job Management, Program Logic 
Manual, Form Y28-6660 are made in the 
topics where the logic is the same as in 

MVT. 

Tables and work areas used by MFT, MFT 
module descriptions , and MFT flowcharts are 
included in the appendixes. 



When a command is encountered in the 
input stream, the reader /interpreter passes 
control to SVC 34 to process the command. 
S^C 34 processes most commands completely 
and returns control to the interrupted 
routine. 

The commands accepted and processed by 
MFT are the following: 



Command Processing 

Operator commands control system operation 
and modify system tasks . Command proces- 
sing in MFT is handled by the communica- 
tions task and the master scheduler task. 
With the exception of DEFINE, and HALT, 
commands can be entered into the system 
through the console or the input job 
stream. The DEFINE and HALT commands can 
be entered only through the console. Com- 
mands entered through the console are read 
by the communications task and routed to 
the master scheduler (see Figure 13). The 
communications task also communicates 
between the system and the operator; it 
handles WTO/WTOR macro instructions , 
assigns message identifiers (including par- 
tition numbers), and maintains reply gueue 
elements. It also deletes messages from 
the CRT display of the Model 85 operator 
console via the DOM macro instruction. 



Console 
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Figure 13. Command Processing Flow 



CANCEL 

DEFINE 

DISPLAY 

HALT 

HOLD 

LOG 

MODE 

MODIFY 

MOUNT 

RELEASE 

REPLY 

RESET 

SET 

START 

STOP 

UNLOAD 

VARY 

WRITELOG 

The format and syntax of these commands 
can be found in IBM System/360 Operating 
System; Operator's Guide , Form C28-6540. 



Communications Task 

The routines that handle opera tor- system 
communication are contained in the communi- 
cations task. Communication may take 
either of two forms: commands , which allow 
the operator to change the status of the 
system or of a job or job step, and WTO or 
WTOR macro instructions, which allow prob- 
lem programs or system components to issue 
messages to the operator. The communica- 
tions task routines also switch functions 
from the primary console device to an 
alternate console device when the INTERRUPT 
key is pressed. 



WTO/WTOR MACRO INSTRUCTION PROCESSING 

Whenever a WTO or WTOR macro instruction is 
issued, a supervisor call (SVC) interrup- 
tion occurs. The supervisor identifies the 
type of interruption and passes control to 
the communications task to issue messages 
and/or to read replies. (See Figure 14.) 



EXTERNAL INTERRUPTION PROCESSING 

When the operator presses the INTEPFUPT 
key, an external interruption occurs. The 
communications task then switches from the 
primary con sole /master console to its 
alternate device. (See Figure 15.) 
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Figure 14. WTO/WTOR Macro Instruction Pro- 
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sing Flow 



Communications Task Modules 

The communications task (Chart 16) receives 
control through interruptions which occur 
when commands are entered or messages are 
written. The following paragraphs describe 
the seven major routines of the communica- 
tions task. 

Console interruption routine (IEECVCR&) : 
notifies the communications task wait rou- 
tine that a console read has been 
requested. 



C ommunications task wait routine (IEE- 
C VCTW) : waits for all WTC/WTCR requests 
and console interrupts and calls the com- 
munications task router routine. 



C ommunications task router routine (IEE- 
C VCTR) : determines the type of request or 
interruption that occurred and passes con- 
trol to the appropriate processing routine. 

C onsole device processor routines (IEE- 
C VPM) ; performs console read and write 
operations and error checking. 



W rite-to-operator routine (IEECVWTC) 
ages WTO buffers. 



man- 



W rite-to-operator with reply routine (I EE- 
VWIOR) ; manages WTOR buffers. 

E xternal interruption routine (IEECVCRX) : 
switches to the alternate console device 
when an external interruption occurs. 



Commands are issued through the console 
device or the input reader. Before enter- 
ing commands through the console device, 
the operator must cause an I/O interruption 
by pressing the REQUEST key. When he does, 
control is given to the supervisor, which 
recognizes the interruption and passes con- 
trol to the I/O supervisor. The I/O super- 
visor determines that the interruption is 
an attention signal and passes control to 
the communications task console interrup- 
tion routine in the nucleus. The console 
interruption routine posts the attention 
event control block (ECB) in the unit con- 
trol module (UCM) and sets the attention 
flag in the UCM list entry corresponding to 
the device from which the interruption 
came. Posting of the attention ECE causes 
the communications task wait routine to be 
dispatched. 

The communications task wait routine 
waits on all communication ECBs associated 
with WTO/WTOR. The wait routine issues a 
multiple WAIT macro instruction on a list 
of ECBs contained in the UCM. When one of 
the ECBs is posted, as by attention or 
external interruptions, the wait is satis- 
fied and the communications task thus 
becomes ready. When it becomes the active 
task, it issues SVC 72. This SVC includes 
the console communication service routines 
and the router. 

The communications task serves a number 
of purposes. The first segment of SVC 72, 
called the router, distinguishes among 
these purposes and establishes the order of 
response. When a posted ECB is found by 
the router, the router passes control to 
the specified processor routine via an XCTL 
macro instruction. 
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The console- device processor routines 
read and write using the EXCP macro 
instruction. The processor routines con- 
sist of a routine to service external 
interruptions and three device -oriented 
routines: 1052 Printer -Keyboard routine, 
card reader routine, and printer routine. 
Each of the three console input/output pro- 
cessor routines is associated with an OPEN/ 
CLOSE support routine, which provides data 
management and input/output supervisor con- 
trol blocks. The specified processor rou- 
tine reads the input message into a buffer 
area and calls the master scheduler task 
via an SVC 34. 

The write- to- operator routine moves the 
text from the requesting program 1 s area to 
a buffer area within the nucleus and posts 
the communication ECB for write-to- 
operator. 

The write- to-operator with reply routine 
generates a message ID, including a parti- 
tion identifier, and creates a reply queue 
element (RPQE) to handle the operator's 
reply . 

The external interruption routine, 
residing in the nucleus, switches to an 
alternate console device when the operator 
presses the INTERRUPT key on the console. 



CONSOLE ATTENTION INTERRUPTION ROUTINE 
(IEECVCRA) 

The console attention interruption routine 
(IEECVCRA), operating in privileged mode, 
posts the communications task attention ECB 
to request reading of the console. Input/ 
output interruptions are disabled without 
destroying register contents, and without 
macro access to supervisor services. Using 
the address of the UCB (found in register 
7), the UCB address is matched to a UCM 
entry. The attention flag for the entry is 
turned on. Control then passes to the POST 
routine, indicating the attention ECB in 
the UCM. The address in register 14 is 
used tor return to the input/output super- 
visor (IOS). 



patched, the wait routine issues an SVC 72 
which results in creation of a supervisor 
request block (SVRB), and fetching of the 
first segment of the console processor rou- 
tines into the system transient area. 



COMMUNICATIONS TASK ROUTER (IEECVCTR) 

The communications task router (IEECVCTR) 
is the first segment of SVC 72 brought into 
the transient area. Because the communica- 
tions task serves a number of purposes, and 
many service requests may be pending, the 
router establishes the order of response. 
The order is: external interruption, 
input/output list completion, attention 
(console interruption), and WTC/WTCR. Mul- 
tiple attentions are treated in order of 
appearance in the UCM. Multiple input/ 
output completions are treated in order of 
first use of the device. The router 
responds to an attention by building a pa- 
rameter list in the SVRB extended save 
area. The parameter list consists of a 
remote XCTL parameter list, the address of 
the appropriate UCM entry, and the address 
of (contents of CVTCUCB) the UCM. The 
router then passes control to a processor 
routine by issuing an XCTL macro instruc- 
tion to the remote parameter list, using 
the name obtained from the unit control 
block (UCB) entry. The flag signifying the 
request to be serviced by the processor 
routine is turned off by the routine. Con- 
sequently, processor routines return con- 
trol to the router by issuing an XCTL macro 
instruction to allow the router to schedule 
service for other requests. If no requests 
are pending, the router exits to the wait 
routine using the address in register 14. 

In addition to distinguishing the output 
request from other requests, the router 
selects the device to which the message is 
to be sent- The router establishes the 
output device by checking UCB entry attrib- 
ute indicators. The appropriate entry is 
the first active UCB entry that supports 
foTO. As before, the router builds a remote 
interface for, and passes control to, a 
processor routine via an XCTL macro 
instruction. 



COMMUNICATIONS TASK WAIT ROUTINE (IEECVCTW) 

Upon entry from the dispatcher, the com- 
munications task wait routine (IEECVCTW) 
issues a WAIT (with a count of one) speci- 
fying the list of ECBs whose address is 
contained in the Event Indication List 
(EIL) . Thus the communications task can 
respond to a variety of events since the 
posting of any one ECB satisfies the wait. 
The POST macro instruction issued in the 
console attention interruption routine 
satisfies the wait, causing the TCE to be 
placed on the ready queue. When next dis- 



CONSOLE DEVICE PROCESSOR ROUTINES 
(IEECVPMX, IEECVPMC, IEECVPMP) 

Control flow in a processor routine is 
determined by the setting of flags in the 
router- selected UCM entry. The close flag 
is tested first. If this flag is on, any 
pending input/output activity is suspended 
by issuing a WAIT macro instruction. Con- 
trol is then passed to an associated OPEN/ 
CLOSE support routine via an XCTL macro 
instruction for release of various control 
blocks. If the close flag is off, the busy 
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flag is tested to determine input/output 
status. If there is outstanding input/ 
output activity, error checking and buffer 
disposition occur if the activity has been 
posted complete. Otherwise, any attention 
request is temporarily abandoned (as are 
output requests), and control returns to 
the router via an XCTL macro instruction. 
If the busy flag is off, the attention flag 
is tested; if it is on, the status of the 
device is examined. If the device has not 
been opened, control passes to an asso- 
ciated OPEN/CLOSE support routine via an 
XCTL macro instruction to obtain storage 
for a DCB and access -method dependent con- 
trol blocks, and for execution of the OPEN 
macro instruction . 

When return is made from the OPEN/CLOSE 
support routine, a response to the atten- 
tion flag is prepared. A fixed buffer in 
the UCB is reserved and an access-method 
dependent interface is constructed. Input/ 
output activity is initiated by issuing an 
EXCP macro instruction for a 1052, and by 
issuing a READ macro instruction for a unit 
record device. In no case does the proces- 
sor routine await completion of this activ- 
ity. Control immediately returns to the 
router via an XCTL macro instruction. 



Control flow within the processor rou- 
tine is as described previously up to the 
point at which the output request flag is 
tested. If the flag is on, the processor 
routine obtains the address of an output 
buffer from the UCM. The element is not 
removed from the queue at this time; this 
occurs only on successful completion of 
input/output activity. This preserves a 
means of retrying the message if an extern- 
al interruption intervenes before the mes- 
sage is successfully presented to the cur- 
rent device. Since output buffers are 
always selected from the top of the queue, 
the initiation of output to an alternate 
device is unaffected by previous attempts 
to present the message to the primary 
device. 

Having selected a buffer, the processor 
routine establishes data management and 
input/output supervisor (IOS) control block 
linkages. The routine then issues an EXCP 
macro instruction for a 1052, or a WRITE 
macro instruction for a printer. Without 
awaiting completion of the input/ out put, 
the processor routine returns to the router 
via an XCTL macro instruction. 



WRITE-TO- OPERATOR ROUTINES (IEECVWTO AND 
IEEVWTOR) 

The write- to- operator routine (SVC 35) 
writes operator messages on the console 
when a WTO or WTOR macro instruction is 



issued by system component programs or 
problem programs. Messages and replies are 
buffered; the period of time between issu- 
ing the message and receiving the reply is 
available for processing. Issuance of 
either macro instruction causes an SVC 
interruption. When the SVC interruption is 
handled, the supervisor causes the write- 
to-operator routine to be loaded into the 
transient area of the nucleus and passes 
control to it. 



There are two console queues; the buff- 
er queue and the reply queue. The extent 
of both queues is defined by specifying the 
number of buffers at system generation. An 
attempt to exceed this value results in the 
requesting task being placed on a queue to 
wait for service; i.e., the task is placed 
in a wait condition. Each WTO and WTOR 
macro instruction results in the addition 
of a WTO Queue Element (WQE) to the buffer 
queue; each WTOR results in the addition of 
a Reply Queue Element (RPQE) to the reply 
queue. SVC 35 (IEECVWTO) sets up the prob- 
lem program message. If it is a WTOR, the 
write-to-operator-with-reply routine (IEEV- 
WTOR) inserts the message identification 
(ID) in addition to a partition identifier. 
The same message ID (which the operator 
must use for his reply) is placed in the 
RPQE with other information to insure pas- 
sing the reply, when received, to the prop- 
er area. WTO messages are always written; 
a WTOR message may be purged (removed from 
the queue) if the issuing task terminates 
while the message is on the buffer queue. 
Therefore, an RPQE differs from a WQE in 
that it contains the address of the issuing 
task f s TCB. The buffer queue is accessed 
through the entry UCMWTCQ in the UCM. 

The reply queue contains RPQEs for 
operator replies to WTCR. Like WTOR ele- 
ments in the buffer queue, RPQES contain a 
TCB address to permit their being purged 
from the queue if the issuing task is 
abnormally terminated. 

For a REPLY (to WTCR) , the processor 
issues SVC 34 (see "Master Scheduler 
Task"). The SVC routine determines that 
the incoming command is a REPLY, processes 
the reply, posts the user's ECB and 
branches back to the processor. 



EXTERNAL INTERRUPTION ROUTINE (IEECVCRX) 

The external interruption routine assigns 
functions performed by the primary console 
device to an alternate console device. 
When the operator presses the INTERRUPT key 
on the console, an external interruption 
occurs and control passes to the supervi- 
sor. The supervisor identifies the inter- 
ruption and passes control to the external 
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interruption routine which switches con- 
soles and returns control to the supervi- 
sor. Console functions may later be reas- 
signed to the primary console device, if 
the operator causes another external 
interruption . 



Note: The routines that support the Model 
85 integrated operator's console with CRT 
display are identical with those used with 
MVT. For a complete description of these 
routines, see IBM System/360 Operating Sys- 
t em: MVT Supervisor , Program Logic Manual , 
Form Y28-6659. 



Communications Task with 
Multiple Console Support 

The MFT communications task with Multiple 
Console Support (MCS) is similar to the MVT 
communications task except that MFT does 
not obtain buffers dynamically. The MCS 
communications task receives control as a 
result of an external interruption, an 
operator console attention, an I/O inter- 
ruption for a console, or a WTO (R) or DOM 
macro instruction . The following para- 
graphs describe the communications task 
routines with MCS (for a detailed descrip- 
tion of these modules see IBM System/ 360 
Operating System: MVT Supervisor , Form 
Y28-6659): 

Communications Task Router Routine ( IEEC- 



MAWR) : waits for the posting of an extern- 



al, attention, I/O, WTO(R), or DOM ECB. 
Control is passed to the appropriate rou- 
tine to handle the posted ECB, to provide 
console switching, or to provide buffer 
management. 

Communications Task Device Interface Rou- 



tine ( IEECMDSV) : passes control to the 



device support routine for the device on 
which I/O is to be performed, or consoli- 
dates system and console output gueues. 

Communications Task Console Switch Routine 



(IEECMCSW) : performs console switching as 



a result of an external interruption, an 
unrecoverable I/O error, or a VARY command. 
It also switches the hard copy log to the 
master console when both log data sets are 
full . 

Communications Task WTO(R) Routine 
(IEECMWSV) : marks WTO gueue elements to 
appropriate console output gueues. 

Communications Task DOM Routine (IEECMDOM) : 
marks WTO gueue elements on the system out- 
put gueue to be purged. 

Console Device Support Routines : provide 
read and write functions for the associated 
console devices. 

The following modules remain unchanged with 
MCS: 

Write- to- operator (IEECVWTO) 
Write- to-operator with reply (IEEVWTOR) 
External Interrupt (IEECVCRX) 
Console Interrupt (IEECVCRA) 



Master Scheduler Task 

The MFT master scheduler task (MST) pro- 
cesses all commands, and initializes main 
storage at system initialization. It is 
composed of the SVC 34 routines and the 
master scheduler resident command processor 
routines. SVC 34 processes all commands 
directly except HOLD, RELEASE, RESET, CAN- 
CEL (inactive jobs), DISPLAY (A,Q,N, 
jobname) , WRITELOG, and DEFINE. SVC 34 
calls the resident command processor to 
complete the processing of all but the WRI- 
TELOG command. When a WRITELOG command is 
found, SVC 34 stores it and posts the Sys- 
tem Log task ECB . 

The master scheduler resides in the nuc- 
leus and operates under control of its own 
TCB. The master scheduler TCB is always 
dispatchable and is of higher priority on 
the TCB gueue than the TCBs for the parti- 
tioned area (the problem program area) of 
storage. Therefore, when a command is 
issued, the master scheduler always gains 
control of the CPU after the communications 
task for processing the command. 

When processing commands, interruptions 
are disabled so that command processing may 
be completed before any other interruptions 
are serviced. Although commands are pro- 
cessed when issued, the command may not 
take effect immediately. An example of 
this is the STOP writer command. The mast- 
er scheduler marks a command scheduling 
control block (CSCB) which is checked by 
the writer between jobs. The command does 
not take effect until the writer completes 
the job it was processing when the command 
was issued. 



MULTIPLE CONSOLE SUPPORT REQUIREMENTS 

In systems that include Multiple Console 
Support (MCS) , a hard copy of all operator 
and system messages is reguired when there 
is an active graphic console or more than 
one active non-graphic console. Because of 
this reguirement, a system log function is 
provided which may be specified as the hard 
copy log. In MFT, the System Log operates 
under its own TCB created at system genera- 
tion. The System Log task is the highest 
priority task in the operating system. The 
master scheduler routine IEFSD569 calls the 
log initialization routine IEEVLIN which 
initializes control blocks and obtains 
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storage for the Log Control Area and the 
log buffer. The Log Support routines in an 
MFT environment function similarly to those 
in an MVT environment. For a further 
description of the system log and the Log 
Support routines with MCS, see IBM System/ 
360 Operating System: MVT Supervisor w Form 



Y28-6659. 



SVC 34' FUNCTIONS 

SVC 34 (Charts 13 , 14 , and 15) is called to 
process all commands. As previously noted, 
it processes some of these commands com- 
pletely and calls the resident command pro- 
cessor to process the remaining commands. 
The commands processed completely by SVC 34 
are: 

START 

STOP 

MODE 

MODIFY 

CANCEL (active jobs only) 

HALT 

MOUNT 

VARY 

UNLOAD 

REPLY 

DISPLAY (JOBNAMES, R, SPACE, DSNAME, 

T, or STATUS) 

For CANCEL (inactive jobs), HOLD, 
RELEASE, RESET, DISPLAY (A, Q, N, jobname), 
and DEFINE commands, SVC 34 does preli- 
minary processing before passing control to 
the resident command processor. If the 
resident command processor is processing a 
DEFINE command, SVC 34 will queue all com- 
mands until the DEFINE command has been 
completely processed. 

For the log command, SVC 34 issues a WTL 
(SVC 36) to have the LOG command processed 
in manner similar to a Write-to-log macro 
instruction issued from a problem program. 

The same routines are used in the MFT 
Command Processor as are used in the MVT 
Command Processor with two exceptions. 
DEFINE, MOUNT, and CANCEL command proces- 
sing is performed in module IEESD571, and 
STOP INIT and START command processing is 
performed in module IEESD561. In addition, 
the Validity Check Command routine 
(IEE0403D) passes control to the MFT rou- 
tines rather than their MVT counterparts 
when operating in an MFT system. The fol- 
lowing paragraphs describe the two MFT rou- 
tines within SVC 34. 



DEFINE, MOUNT , and CANCEL Routine 
(IEESD571) 

This routine processes the DEFINE command 
by setting the necessary indicators in the 



master scheduler resident data area. It 
then posts the ECB for the resident command 
processor IEECIR50. This routine also pro- 
cesses the CANCEL command (for active 
jobs), and the MOUNT command. 



MOUNT processing parallels that of PCP 
by building a parameter list for, and issu- 
ing an XCTL macro instruction to the PCP 
master command EXCP routine (IGC0103D). 



Canceling of an active job is handled by 
scanning the CSCBs for a jobname compare. 
If the compare is equal and the CSCB is 
marked cancelable, IEESD571 issues a BALR 
to ABTERM with the job's TCB address and 
proper completion code dump indication. If 
the CSCB is not marked cancelable, the CSCB 
is marked canceled and is posted. If the 
job is not found, IEESD571 passes control 
to the CSCB creation routine (IEE0803D) via 
an XCTL macro instruction, to CANCEL the 
jobname on the job queue. (See IBM System/ 
360 Operating System: MVT Job Management , 
Program Logic Manual , Form Y28-6660, for a 
description of IEE0803D.) 



S TOP INIT and START Commands Routine 
(IEESD561) 

This routine processes all the START com- 
mands and the STOP INIT command. (The STOP 
commands that deal with console displays of 
job names, data set names, and space avail- 
able are processed by IGC0703D.) When pro- 
cessing a START command, the routine first 
examines the command parameters. If any- 
thing other than a system reader or writer 
is to be started, the routine determines 
the number and status of the partition. 
The routine then builds and chains a CSCB, 
passes the address of the CSCB to the par- 
tition's PIB, and posts the partition. If 
a system reader is to be started, the rou- 
tine searches for a scheduler-size problem 
partition which is inactive; if a system 
writer is to be started, the routine 
searches for any inactive problem parti- 
tion. If a partition is located, the rou- 
tine builds and processes a CSCB as stated 
above. If a partition cannot be found, the 
routine issues a message to the operator 
stating that the command has failed. 



To process a STOP INIT command the rou- 
tine determines which partition contains 
the initiator to be stopped, verifies that 
the partition contains an initiator, and 
sets the STOP INIT indicator in the parti- 
tion's PIB. If the routine cannot process 
the command, it will issue a message to the 
operator stating that the command has 
failed. 
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•Figure 16. START Command Processing Flow 

Machine Status Control Routines (IGF2603D 
and IGF2703D) 



These routines process the MODE command 
which is valid only for the Model 85, The 
operator obtains a display of machine sta- 
tus by issuing the MODE command with the 
parameter STATUS, This parameter is pro- 
cessed by machine status control routine 
IGF2603D. If the parameter is other than 
STATUS, machine status control routine 
IGF2703D processes the parameter to allow 
the operator to control the mode of record- 
ing soft machine checks, to reactivate pre- 
viously deleted buffer sectors or the high 
speed multiply circuitry, and to restore 
machine status to the system reset condi- 
tion. Exit from either routine is via an 
SVC 3. 

The Machine Status Control modules are 
part of the Master Scheduler but are stored 
with modules relating to RMS/85 and given 
the RMS/85 identification of IGF rather 
than the Master Scheduler identification of 
IEE. 

For a more detailed description of the 
MODE command, see IBM System/360 Operator's 
Guide , Form C28-6540. For a more detailed 
description of the Machine Status Control 
modules, see IBM System/ 3 60 Machine Check 
Handler for Model 85 , Form Y27-7128. 



SYSTEM INITIALIZATION 

The master scheduler task (Chart 09) per- 
forms the function of initializing main 
storage. In MVT this is done by NIP. In 
MFT it is done by the master scheduler to 
facilitate redefinition of main storage. 
The following paragraphs describe the 
action of the master scheduler in defining 
main storage at system initialization. 



The master scheduler task is loaded with 
the nucleus. Its task control block (TCB) 
points to the master scheduler request 
block (RB) in the nucleus. NIP saves the 
RB address and the contents of the boundary 
box describing the normal master scheduler 
task partition, for later use by the master 
scheduler initialization routine IEFSD569. 
(Note: IEFSD569 is brought into main 
storage by the macro instruction SGIEEOW 
generated during system generation.) 



The boundary box (BBX)is then changed 
by NIP to describe a partition including 
all of storage except the nucleus. The 
address of an RB at the low address of this 
partition is placed in the master scheduler 
TCB. NIP then creates the RB. The RB 
points to an XCTL to IEFSD569. NIP then 
sets the master scheduler task dispatchable 
and branches to the dispatcher. 



The master scheduler initialization rou- 
tine is given control to perform scheduler 
initialization. First it passes control to 
the communications task initialization rou- 
tine (IEECVCTI) via a LINK macro instruc- 
tion. After the communications task is 
initialized, the master scheduler initiali- 
zation routine passes control to the 
definition routine, IEEDFIN1, via a LINK 
macro instruction. IEEDFIN1 communicates 
with the operator, or prepares the parti- 
tion as it was described at system genera- 
tion. IEFSD569 then issues the READY mes- 
sage, and if the system log was requested, 
passes control to IEEVLIN to initialize the 
system log. It then types the automatic 
commands, and issues a WAIT macro instruc- 
tion. 



When the operator presses the REQUEST 
key, control is given to the supervisor 
which recognizes the interruption and 
passes control to the input/output supervi- 
sor. The input/output supervisor deter- 
mines that the interruption is an attention 
signal and passes control to communications 
task console attention interrupt routine 
(described above). The interrupt routine 
posts the communications task attention ECB 
to request reading of the console. The 
operator enters a SET command. SVC 34 
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posts the WAIT and places the parameters of 
the SET command in the master scheduler 
resident data area. The master scheduler 
initialization routine then regains control 
to continue processing. Control blocks for 
the job queue and procedure library are 
created. To format the job queue, the rou- 
tine passes control to queue initialization 
routine IEFSD055 via a LINK macro instruc- 
tion which places a queue control record 
(QCR) in the nucleus after the DCB and DEB. 
Control then passes to queue manager for- 
matting routine IEFORMAT which formats the 
job queue and returns control to the queue 
initialization routine. (For a discussion 
of these two modules , see the topic "Queue 
Manager" . ) After return from the queue 
manager initialization routine, the master 
scheduler initialization module displays 
and processes any automatic commands. 

The master scheduler initialization rou- 
tine then establishes partitions based on 
information in the TCBs . It constructs an 
RB in each partition, with an XCTL macro 
instruction addressing job selection module 
IEFSD510 (for large partitions), or small 
partition module IEFSD599 (for small parti- 
tions) . The master scheduler initializa- 
tion routine then readjusts the pointers to 
the master scheduler area, and returns to 
the dispatcher. The dispatcher returns 
control to the master scheduler task, but 
the TCB now points to master scheduler 
router routine IEECIR50, in the nucleus. 



queues (SYS1.SYSJ0BQE) is required for pro- 
cessing the command , the syntax check rou- 
tine sets internal codes for the queue 
search, issues a GETMAIN to obtain storage, 
and constructs an event control block (ECB) 
and an input/output block (ICB) . Control 
is then passed to queue search setup rou- 
tine IEESD563. If the command was a DIS- 
PLAY A command, control is passed to DIS- 
PLAY A routine IEESD566. If it was a DIS- 
PLAY CONSOLES command, control is passed to 
DISPLAY CONSOLES routine IEEXEDNA. 



Q ueue Search Setup Routine (IEESD563) 

Queue search setup routine IEESD563 deter- 
mines which of the queues is to be searched 
and reads the queue control record (QCR) 
for that queue. If the queue must be 
searched, the queue search setup routine 
establishes parameters for the search. The 
queue search setup routine then passes con- 
trol to queue search routine IEESD564 via 
an XCTL macro instruction. When the queue 
search setup routine regains control, the 
QCR is scanned and if any information in 
the record has been changed, the updated 
information is rewritten on SYS1.SYSJCBQE. 
The queue search setup routine then estab- 
lishes a parameter list and passes control 
to service routine IEFSD565 via an XCTL 
macro instruction. 



Master Scheduler Router Routine (IEECIR50) 

Resident master scheduler router routine 
IEECIR50 waits on an ECE which is posted by 
SVC 34 when a command has been scheduled 
for processing. This router (Chart 12) 
scans the CSCB chain for any outstanding 
commands to be processed. If a command is 
found, the CSCB is removed from the chain. 
The router routine then passes control to 
syntax check routine IEESD562 via a LINK 
macro instruction, passing the address of 
the CSCB. 

After all commands are processed, or if 
none are found, the router routine deter- 
mines if a DEFINE command has been entered. 
If so, the router routine passes control to 
IEEDFIN1, the first module of the defini- 
tion routines, via a LINK macro instruc- 
tion. If no DEFINE command has been 
issued, the router routine returns to wait 
on its ECB. No test is made for DEFINE 
command scheduling .until all other commands 
have been processed. 

Syntax Check Routine (IEESD562) 

Syntax check routine IEESD562 checks the 
syntax of the command parameter in the CSCB 
(Chart 10). If a search of the input work 



Q ueue Search Routine (IEESD564) 

Queue search routine IEESD564 reads the 
entries of a queue based on the parameter 
information passed by setup routine 
IEESD563. If the command processing 
requires changes in the chaining informa- 
tion in a queue entry or control record, 
the updated information is written on the 
queue. Action indicators are passed as pa- 
rameters when control returns to setup rou- 
tine IEESD563. 



S ervice Routine (IEESD565) 

Based on the information passed by the cal- 
ling routine, service routine IEESD565 per- 
forms the following: 

1. Passes control to queue manager 
enqueue routine IEFQMNQQ via a LINK 
macro instruction to enqueue an entry 
or QCR. 

2. Issues a FREEMAIN macro instruction to 
free the ECB/ICB which was used to 
read SYS1 . SYS JOBQE . 

3. Passes control to the master scheduler 
message module (IEE0503D) via a LINK 
macro instruction to write a message. 
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If another queue needs to be searched, 
it passes control to queue search set 
up routine IEESD563 via an XCTL macro 
instruction. 



After the requested processing has been 
performed, the service routine transfers 
control to router routine IEECIR50. 



DISPLAY A Routine (IEESD566) 

DISPLAY A routine IEESB566 receives control 
from syntax check routine IEESD562 when the 
DISPLAY A (active) command is entered. 
This routine constructs WTO messages con- 
taining the active job and stepnames. The 
DISPLAY A routine returns control to the 
router routine. 



DI S PLAY C CNSCLES Rout ine (IEEXEDNA) 



DISPLAY CONSOLES routine IEEXEDNA receives 
control from the Syntax Check routine 
IEESD562 when the DISPLAY CONSOLES command 
is entered. This routine issues a header 
message that describes the status message. 
It then constructs and issues a message 
describing the status of the hard copy log 
(if one exists) and each console in the 
system, both active and inactive. When the 
message is issued, it returns to the Master 
Scheduler Router routine IEECIR50. 



PARTITION DEFINITION BY THE MASTER 
SCHEDULER 

The master scheduler uses the DEFINE com- 
mand processing routines (shown in Figure 
17) to initialize or change partition 
definitions in MFT. These routines handle ; 



• Commands from the operator via a con- 
sole, issued after nucleus initializa- 
tion, to change the size and descrip- 
tion of any partition while processing 
continues in unaffected partitions. 

• Commands from the system at IPL time to 
prepare the partition as it was 
described at system generation. 

All transfers of control among the proces- 
sing routines are accomplished via an XCTL 
macro instruction. 



DEFINE Command Initialization Routine 
(IEEDFIN1) 



The master scheduler passes control to 
DEFINE command initialization routine IEED- 
FIN1 whenever a DEFINE command is entered 



by the operator. The routine also receives 
control from the master scheduler during 
system initialization, after the nucleus 
initialization program (NIP) completes its 
preparation of the system. In either case 
the routine builds the DEFINE data area 
containing the size and description (job 
classes A-0, or R or W) of each partition 
If Main Storage Hierarchy Support is 
included in the system, the data area con- 
tains the size of the partitions in terms 
of hierarchies. Hierarchy represents 
processor storage and hierarchy 1 repre- 
sents 2361 Core Storage. 



If the time- slicing feature is included 
in the system, the data area also contains 
a doubleword of time- slicing information, 
including the first and last partition num- 
bers in the time- si icing group and the time 
interval (in milliseconds) assigned to the 
group of partitions. This data is used at 
completion of DEFINE processing to define 
the partitioning of main storage. 



If the DEFINE command initialization 
routine was entered as the result of a 
DEFINE command, the routine issues a DEFINE 
COMMAND BEING PROCESSED message to all 
active consoles. It then determines wheth- 
er LIST was specified and if so, passes 
control to listing routine IEEDFIN4. If 
not, the routine passes control to message 
routine IEEDFIN5 for issuance of an ENTER 
DEFINITION message. 



If the DEFINE command initialization 
routine was entered during the system 
initialization, the routine also issues a 
DEFINE COMMAND BEING PROCESSED message to 
all active consoles. It then determines 
whether partition redefinition or LIST was 
specified by the operator, and if not, 
passes control to validity check routine 
IEEDFIN3. If either LIST or partition 
redefinition was specified, the routine 
continues processing as if a DEFINE command 
had been entered by the operator. 



Syntax Check Routine (IEEDFIN2) 

When syntax check routine IEEDFIN2 receives 
control at primary entry point IEEDFIK2, it 
translates the statements entered by the 
operator to upper case. When the routine 
receives control at secondary entry point 
IEEDPART, this operation is bypassed. 



The statement is scanned and each entry 
in the statement — a partition definition, 
a time-slicing change, or a keyword — is 
processed separately. 



50 



From NIP or DEFINE Command 



Q En *y ) 



IEEDFIN1 



(a J (^ Return J* 



IEEDFIN3 



No 




IEEDFIN8 



Wait For 

Affected Partitions 
to Quiesce 



Set Key to Zero 
if Protected 
System 




Build Request 
Blocks, Set up 
Boundary Box, 
Update PIB 



IEEDFIN9 



Update TCBs for 
Time Slicing if 
Specified 



lEERExrr 



Free Work area for 
IEEDFIN3and 
get message 
code in register 



©■ 




Issue DEFINE 
COMMAND BEING 
PROCESSED 
message to all 
active consoles 



Build Data Area 




IEEDFIN4 



Yes 




IEEDFIN5 



©■ 



f Return J* 



Issue Proper 
Message 



IEEDFIN2 



© 



IEEDFIN6 



Get Next Line 
From Console and 
Translate it to 
Upper Case 



mmm 




© 



© 



Yes 




h'M^Syntax Error^, 
No 



Update Permanent 
Tables With 
Partition 
Information 



lYesi 




^Syntax Error 
INo 



Update 

Permanent Table 
with Time Slicing 
Information 



Get Next Entry 



Get Next Entry 



© 



IEEDFIN7 








0- 



Keyword Errorj 




Yes 



No 



■© 



Update Permanent 
Table With 
Keyword 
Indicator 



Yes 




nd of InpuP 




No 



Get Next Entry 



© © 



•Figure 17. DEFINE Command Processing Flow 



Job Management 51 



If the entry is a partition definition, 
the routine checks the entry for syntax 
errors. If a syntax error is found, the 
routine passes control to message routine 
IEEDFIN5 for issuance of the appropriate 
syntax error message. The erroneous entry 
and all following entries are ignored. If 
the syntax is correct, IEEDFIN2 updates the 
DEFINE data area with the partition infor- 
mation and gets the next entry for 
processing. 

If the entry is a time-slicing change, 
the routine passes control to time-slice 
check routine IEEDFIN6. 

If the entry is neither a partition 
definition, nor a time-slicing change, the 
routine assumes that it is a keyword and 
passes control to keyword scan routine 

IEEDFIN7. 

Validity Check Routine (IEEDFIN3) 



Validity check routine IEEDFIN3 makes final 
checks to determine that the information 
entered by the operator is correct (e.g., 
that the definition changes which have been 
requested are within legal bounds or that 
the time- slicing specification is valid). 
If an error is detected, the routine passes 
control to IEEREXIT, a secondary entry 
point in command final processor routine 
IEEDFIN9. If the information is valid, the 
routine determines the partitions affected 
by the DEFINE command and constructs a list 
of PIB pointers (one for each affected 
active partition). 

If Main Storage Hierarchy Support is 
included in the system, IEEDFIN3 determines 
if a partition has been defined in two seg- 
ments. If both HO and HI size have been 
reduced to zero, the routine marks the par- 
tition inactive in the DEFINE data area. 
It also checks to determine if a partition 
has been specified for excess bytes result- 
ing from a redefinition in either HO or HI 
of an adjacent partition. If no partition 
has been specified, the routine passes con- 
trol to secondary entry point IEEREXIT in 
command final processor routine IEEDFIN9. 
Otherwise, it sets up a message indicating 
the number of excess bytes, the partition, 
and the hierarchy to which they have been 
added. It then passes control to IEEREXIT. 

If the information is valid, IEEDFIN3 
passes control to system reinitialization 
routine IEEDFIN8 . 

Listing Routine (IEEDFIN4) 

Listing routine IEEDFIN4 lists partition 
definitions and job classes. If the time- 
slicing feature is in the system, it also 
lists the time-slicing attributes. After 
performing the listing function, the rou- 



tine determines whether an END keyword has 
been read from the console, and if so, 
passes control to validity check routine 
IEEDFIN3. If not, it passes control to 
message routine IEEDFIN5. 

Message Routine (IEEDFIN5) 

Message routine IEEDFIN5 handles the mes- 
sages required by the DEFINE command pro- 
cessing routines. These messages, which 
are written to the operator, are concerned 
with: 

• Entering and continuing the definition 
of partitions. 

• Syntax, parameter, and time- slicing 
errors. 

• Illegal number of partitions or over- 
size partitions. 

• Completing the definition of 
partitions. 

After issuing the appropriate message, the 
routine determines whether processing is 
complete and if so, issues a DEFINITION 
COMPLETED message to all active consoles. 
It then determines if a DEFINITION CAN- 
CELLED message has previously been issued 
and if so, tests to see if the system is 
being initialized. If the message has been 
issued and it is IPL time, IEEDFIN5 passes 
control to command initialization routine 
IEEDFIN1 to repeat the DEFINE command pro- 
cessing. If the DEFINITION CANCELLED mes- 
sage has not been issued, or if it has been 
issued at other than IPL time, the routine 
returns control to the caller. 

If processing is not complete, IEEDFIN5 
passes control to syntax check routine 
IEEDFIN2. 

T ime- Slice Syntax Check Routine (IEEDFIN6) 

Time- slice syntax check routine IEEDFIN6 
checks the time- slicing entry for syntax 
errors. If a syntax error is found, the 
routine passes control to message routine 
IEEDFIN5 for issuance of a PARAMETER ERROR 
message. It ignores the erroneous entry 
and all following entries. If there are no 
syntax errors, the routine updates the 
DEFINE data area with the time -slicing 
information, gets the next entry in the 
statement being processed, and passes con- 
trol to secondary entry point IEEDPART in 
syntax check routine IEEDFIN2. 

K eyword Scan Routine (IEEDFIN7) 

Keyword scan routine IEEDFIN7 determines 
whether the entry being processed is a 
valid keyword. If it is not a valid key- 
word, the routine passes control to message 
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routine IEEDFIN5 for issuance of a PARAME- 
TER ERROR message. It ignores the 
erroneous entry and all following entries. 
If a valid keyword is found , the routine 
sets the appropriate keyword indicator in 
the DEFINE data area. 

If there are more entries to be pro- 
cessed the routine gets the next entry and 
passes control to secondary entry point 
IEEDPART in syntax check routine IEEDFIN2. 

If there are no more entries to be pro- 
cessed (end of input), the routine deter- 
mines whether a LIST keyword has been 
entered and if so, passes control to list- 
ing routine IEEDFIN4 . If LIST was not spe- 
cified, a check for the END keyword is 
made. If an END entry is found, the rou- 
tine passes control to validity check rou- 
tine IEEDFIN3. If an END entry is not 
found, the routine passes control to mes- 
sage routine IEEDFIN5 for issuance of a 
CONTINUE DEFINITION message. 

System Reinitalization Routine (IEEDFIN8) 



System reinitialization routine IEEDFIN8 
places the ECB that must be posted by the 
affected partition in the PIB of the parti- 
tion. If a partition has been marked inac- 
tive (i.e., no HO or HI size is contained 
in the DEFINE data area), IEEDFIN8 sets the 
partition's TCB nondisp at enable. If any 
partition being redefined contains a system 
writer, the routine posts the STOP ECB in 
the Start Parameter List to stop the writer 
as if a "Stop Writer" command had been 
issued from the console. Therefore the 
operator must issue a "Start Writer" com- 
mand for any writer partition involved in 
the redefinition. 

The routine then issues the WAIT macro 
instruction for the posting of the ECB 
list. When the ECB list is posted, IEED- 
FIN8 sets the protection key to zero if the 
system is protected. It makes one final 
check to determine that no more than 15 
problem program partitions have been 
defined. If an error is found, the routine 
passes control to secondary entry point 
IEEREXIT in command final processor routine 
IEEDFIN9. 

If no error is found, IEEDFIN8 uses the 
information in the DEFINE data area to 
build request blocks and boundary boxes for 
the defined partition. The routine then 
passes control to IEEDFIN9 at its primary 
entry point, IEEDFIN9 . 

Command Final Processor Routine (IEEEFIN9) 



Command final processor routine IEEDFIN9 
updates the time- si ice control element and 
the task control blocks affected by time- 
slicing if this feature is specified. The 



routine then passes control to message rou- 
tine IEEDFIN5 for issuance of the DEFINI- 
TION COMPLETED message. 



If the routine receives control from 
validity check routine IEEDFIN3, it frees 
the work area obtained by its caller. It 
passes control to IEEDFIN5 for issuance of 
the appropriate error message specified by 
its caller (IEEDFIN3 or IEEDFIN8). 



Job Processing 

Job processing is accomplished by three 
types of tasks: 

• Reading tasks , which control the read- 
ing of input job streams and the inter- 
preting of control statements in these 
input streams. 

• Initiating tasks , which control the 
initiating of job steps whose control 
statements have been read and inter- 
preted. (Terminating procedures are 
also part of initiating tasks.) 

• Writing tasks , which control the 
transferring of system messages and 
user data sets from direct-access 
volumes on which they were written ini- 
tially to some other external storage 
medium. 



These tasks are created in response to 
START commands entered for readers, initia- 
tors, and writers. Whenever a START reader 
or writer command is entered, the resulting 
command processing brings a reader or writ- 
er into the associated partition. Initia- 
tors are brought into all scheduler-size 
partitions at system initialization, and 
after a START INIT command has been issued 
following partition redefinition. An 
initiator is also brought into a partition 
that is specified in a STOP INIT command to 
terminate the initiator. 



I There may be more than one of each of 
the job processing tasks so long as the 

I total does not exceed 52. Input job 
streams may be read simultaneously from 
three input devices by issuing a START 
reader command for each input stream. Sys- 
tem messages or data sets may be written to 
as many as 36 output devices by issuing a 
START command for each device. Up to 15 
initiating tasks can exist concurrently. 
Each initiating task is created in response 
to a START INIT command issued for a spe- 
cific partition, or a START INIT. ALL com- 
mand. (See IBM System/360 Operating Sys- 
t em: Operator's Guide , Form C28-6540.) 
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This section is divided into six topics, 
including the three major tasks discussed 
above, and three other areas associated 
with the major tasks: Queue Manager, Sys- 
tem Task Control, and System Restart. 



QUEUE MANAGER 

MFT uses the MVT Queue Manager. However, 
to reduce possible interlocks due to 
unavailability of requested tracks, the 
assign routine (IEFQASGQ) has been modi- 
fied, and a new module (IEF^D572) has been 
added. A table breakup routine (IEFSD514) 
has also been added to subdivide variable 
size tables located in main storage into 
176-byte data records on disk. Descrip- 
tions of some MVT modules have also been 
included to provide a more complete 
explanation of the relationship of these 
modules to the entire system. 



WORK QUEUES 

An MFT system contains 54 work queues which 
form the job queue data set (SYS1. 
SYSJCBQE). These 54 work queues are: 

• Automatic SYSIN blocking queue. 

• HOLD queue. 

• Remote job entry (RJE) queue. 

• 36 output class queues. 

• 15 input job class queues. 

The job entries are enqueued in priority 
order within each job class on the appro- 
priate job class queue. Jobs are selected 
for processing according to the job class 
designation of the partition requesting 
work . 



Queue Manager 

Queue Manager is a general term describing 
a group of routines used by various system 
components, such as the reader/interpreter, 
initiator/terminator, and output writer. 
The queue manager performs some common 
functions for all system components. It 
performs all input/output for accessing the 
job queue data set and keeps track of all 
space on this queue. The queue manager 
assigns space on the job queue in logical 
track increments for control blocks, 
tables, and system messages built by the 
scheduler. When the control blocks and 
tables have been created, the reader/ 
interpreter enqueues (ENQs) the job using 
the queue manager. After the job is 
enqueued, the initiator dequeues (DEQs) the 
job for execution when a partition that is 
assigned to service that job class becomes 



available for work. The terminator places 
control information needed by the system 
output writer on the job queue. At job 
termination, the terminator enqueues the 
output work description. The writer then 
dequeues the output work according to out- 
put class and priority within the class, 
and transcribes it to the appropriate 
device, specified by the user. 

At system generation, the space for the 
job queue data set is allocated. The 
device upon which the job queue resides is 
considered a non -demountable system resi- 
dence volume. 



JOB QUEUE INITIALIZATION 

At system initialization, queue initializa- 
tion routine IEFSD055 receives control from 
the SET command processor to construct a 
data control block (DCB) in the nucleus, 
and to issue an OPEN macro instruction 
which causes a data event block (DEB) to be 
built for accessing SYS1. SYSJCBQE. It also 
places a queue manager master queue control 
record (master QCR) in the nucleus after 
the DCB and DEB. (See Figure 18 for the 
format of the master QCR.) Control then 
passes to queue formatting routine 
IEFORMAT. 
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•Figure 18. Master Queue Control Record 
(Master QCR) Format 
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The queue formatting routine divides the 
job queue data set into a control record 
area and a logical track area. The control 
record area contains a copy of the master 

I QCR, a control record for the automatic 
SYSIN batching (ASB) queue, a control reco- 
rd for the HCLD queue # a control record for 
the Remote Job Entry (RJE) queue, a control 
record for each of the 36 SYSOUT writer 
classes, and a control record for each of 
the 15 input work queues. (See Figure 19 
for the format of an input queue control 
record.) 



Note : The first position of the job queue 
control record (job QCR) contains zeros if 
no work exists. The job QCR contains a 
minimum of two entries if work exists for 
at least one priority. 



Ifrom 10 to 255 records. The number may be 
modified within this range at IPL. All 
tables, control blocks, and system messages 
are in 176-byte increments. 



At system initialization, all tracks are 
members of the free track queue. The free 
track queue is a list of logical tracks 
available for assignment to work queues. 
As tracks are needed, they are taken from 
the free track queue. When the system is 
finished with tracks, they are returned to 
the free track queue. After system initia- 
lization, SYS1.SYSJCBQE appears as shown in 
Figure 21. Figure 22 illustrates typical 
input and output work queues. Each input 
and output QCR contains the address of the 
last entry in each priority queue. 



The job class specified by the user (on 
the JOB statement or in a START command) is 
converted by the system to match the 
system- assigned job class identifiers. The 
user- assigned job class and corresponding 
system job class identifiers are: 
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The logical track area length is vari- 
able. Logical tracks are used instead of 
physical tracks so that the job queue can 
reside on different device types. Each 

I logical track contains a 20-byte header 
record (LTH) (as shown in Figure 20) which 
includes a pointer to the next track. The 
header record is used to chain all tracks 
of a job together. When the job is 
enqueued, the header record is used to 
chain jobs first- in/ first -out (FIFO) 
according to priority. All jobs of the 
same job class are chained together. Fol- 
lowing the header record are a variable 
number of 17 6- byte data records. The num- 
ber of records per logical track is deter- 
| mined at system generation and may range 



QUEUE MANAGER MODULES 

As jobs are read into the system, they are 
placed into each job class queue according 
tc priority (established by the PRTY param- 
eter on the JOB statement) . When the 
reader /interpreter reads a job or estab- 
lishes a new queue for an output class, it 
establishes a queue entry. This is done by 
Assign/Start Routine IEFQASGT. 



Assign/Start Routine (IEFQAGST) 

Ihe Assign/Start routine takes the first 
track from the available track pool and 
establishes it as the first track for a 
job. The queue manager parameter area 
(QMPA) is updated accordingly. (See IBM 
System/360 Operating System: MVT Job Man- 
agement, Program Logic Manual , Form Y28- 
6660, for a description of QMPA.) An ICB 
and an ECB are created for subsequent 
input/output operations. The actual 
reserving of tracks is done by the assign 
routine, IEFQASGQ. 

Note : MFT does not support the track- 
stacking facility of MVT. 



A ssign Routine (IEFQASGQ) 

The assign routine assigns record space on 
the job queue, and determines whether the 
requested blocks can be assigned to the 
current track. If so, the record addresses 
are placed in the external parameter list 
of the QMPA, and the records-available 
field of the QMPA is decremented to reflect 
this assignment. If additional logical 
tracks must be assigned, this routine 
issues an ENQ macro instruction on the 
master QCR to prevent concurrent access by 
other tasks. The master QCR is read into 
main storage. 
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Figure 19. Job Queue Control Record (QCR) 
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I Type: 

1 = HOLD queue 
f 2=ASBqueue 

3-38 = Output class queues 
| 39 = RJE queue 

40-54 = Input work queues 

•Figure 20. Logical Track Header (LTH) 
Record Format 

The primary user of this assign routine 
is the reader/ interpreter, although the 
initiator/terminator also uses it. To pre- 
vent the possibility of the reader/ 
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Reserved 


4 
Reserved 


1 
Reserved 


2 
First logical track of the job 


1 
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Next logical track of the job 


1 
Number of 
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1 
Type* 


1 
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Jobclass of 
the job 


2 
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next job 



interpreter taking all the space and making 
it impossible for jobs to be initiated or 
terminated, two limit values have been 
added: the number of tracks reserved for 
initiating a job, and the number of tracks 
reserved for terminating a job. 

If logical tracks are available, the 
requested tracks are acquired. The address 
of the first available logical track is 
updated and the newly assigned tracks are 
chained to the tracks assigned to the job. 
The master QCR is written to the control 
record area of the job queue data set. A 
DEQ macro instruction is issued to make the 
master QCR available to the next user. 



If there are no available logical 
tracks, and the requesting routine is a 
reader/interpreter, the assign routine 
passes control to queue manager/interpreter 
interlock routine IEFSD572. If the reader/ 
interpreter is resident, control returns to 
the assign routine to wait for tracks to 
become available. If the reader/ 
interpreter is transient, IEFSD572 issues a 
message to the operator requesting him to 
reply "WAIT" or "CANCEL". If the reply is 
foAIT, control returns to the assign rou- 
tine, otherwise control is passed to the 
ABEND routines to cancel the 
reader/interpr eter . 
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•Figure 21. Sample Job Queue (SYS1.SYSJOBQE) Format After Initialization 



If there are no available logical tracks 
and the requesting routine is an initiator/ 
terminator, the assign routine issues a 
message to the operator stating that queue 
space has been exceeded and passes control 
back to the initiator/terminator to cancel 
the job. 



When the requesting routine is assigned 
the record TTRs, it can read and write 
records on the job queue. The master QCR 
is written, and a DEQ macro instruction is 
issued to make the master QCR available to 
the next user. The record addresses in 
storage and TTR pointers are contained in 
the external parameter list of the QMPA. 
When available space on the job queue 
becomes critical, a warning is sent to the 
requesting task. Logical tracks are 
removed from the pool of available tracks 
and assigned to the job. 



If the reply is CANCEL, the interlock 
routine deletes all queue space assigned to 
the job, cancels the job f and returns con- 
trol to the assign routine. Normal initia- 
tor operation recovers the partition for 
further use. 



I nterpreter/Queue Manager Interlock Routine 
( IEFSD572) 

When the reader/interpreter requests tracks 
for the job it is processing, and no space 
is available, IEFQASGQ passes control to 
interlock routine IEFSD572 to identify 
whether an interlock can occur. If the 
reader is transient, the possibility exists 
that space needed by the reader/interpreter 
can be provided only by the termination 
routines, which must operate in the parti- 
tion that the reader occupies. Because the 
requested space is not available, the rou- 
tine issues a message to the operator re- 
questing a reply of 'WAIT' or ■CANCEL*. If 
the reply is WAIT, this routine returns to 
the assign routine to wait for available 
space. (If the reader requesting space is 
a resident reader, no message is issued, 
and a reply of WAIT is assumed.) 



If the reply is CANCEL, control passes 
to delete routine IEFQDELQ to delete all 
queue space assigned to the job being pro- 
cessed (if any space had already been 
assigned). When control returns, the 
interlock routine abnormally terminates the 
job with a job-canceled code of 222. Norm- 
al initiator operation recovers the parti- 
tion for further use. 
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Figure 22 . Input and Output Queue Entries 
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Queue Manager Enqueue Routine (IEFQMNQQ) 

After all control blocks for a job have 
been written, the job is eligible for 
selection by an Initiator. Declaring a job 
ready for selection (enqueuing) is done by 
Queue Manager Enqueue routine IEFQMNQQ. 

When an interpreter has completed the 
processing of a job, (all records generated 
by the interpreter have been written on the 
queue), it uses this routine to enqueue the 
job, in priority order, on the appropriate 
job class input work queue. When a job 
completes processing, the terminator uses 
this routine to enqueue output data sets, 
in priority order, on the appropriate out- 
put work queues. 

To prevent concurrent updates, this rou- 
tine issues an ENQ macro instruction for 
the queue control record (QCR) of the prop- 
er queue. When the QCR becomes available, 
it is read into main storage. The enqueue 
routine then places the new queue entry 
after the last entry with the same priority 
as shown in Figure 22. The address of the 
new entry is then placed in the track head- 
er of the prior entry (maintaining a 
chain), and in the QCR position for that 
priority. The job control table (JCT) is 
written. The updated QCR is written on the 
job queue. A DEQ macro instruction is 
issued making the QCR available. Control 
is then returned to the calling routine. 

Dequeue Routine (IEFQMDQQ) 

In addition to dequeuing a job from the 
input queue for an initiator, the dequeue 
routine (IEFQMDQQ) removes the output data 
from an output queue for processing by a 
system output writer. 

The routine issues an ENQ macro instruc- 
tion on the QCR of the selected queue. 
When the QCR becomes available, the dequeue 
routine reads it into main storage. The 
QCR is examined for a job belonging to the 
same job class as the partition. Upon 
finding a job, this routine adjusts the 
chain. If none is found, the requesting 
task tries the next job class. If nc work 
is found on any of the selected queues (up 
to three), the requester places itself in a 
wait state. In the case of an output writ- 
er, a pointer to the "no work" ECB is 
placed in the QCR. If a pointer already 
exists, the ECB is chained to the last ECB 
waiting for that output class. Then the 
updated QCR is written and a DEQ macro 
instruction is issued making the QCR 
available. 

Once a job has completed processing, or 
the output writer has written all records 
for a job, the tracks are returned to the 
system. This is known as deleting a job 



and is handled by the queue manager delete 
routine IEFQDELQ. 

D elete Routine (IEFQDEIQ) 

The Delete routine first issues an ENQ 
macro instruction on the master QCR of the 
free chain of tracks. After control is 
returned, the record is updated to reflect 
the new available tracks. The prior last 
track of free storage is updated to point 
to the new set of free tracks. After the 
master QCR is updated, it is written and a 
DEQ macro instruction is issued against it. 
The ECB indicating wait-f or-space is 
posted. 

Table Breakup Routine (IEFSD5HO 

When a reader must be suspended, the job 
scheduler must prevent the destruction of 
variable size tables in main storage. To 
do this, it calls the queue manager table 
breakup routine, IEFDS514, (Chart 10) which 
subdivides tables in main storage and 
writes them on disk as 176-byte data reco- 
rds. The data records are written in a 
queue entry related to the caller. The job 
scheduler calls IEFSD514 to retrieve the 
176-byte data records and to reconstruct 
the tables in main storage. Whether read- 
ing or writing tables, the caller must 
build a parameter list (see Figure 23) and 
place the address of the list in general 
register 1 before calling the TBR. 

When the tables are written initially, 
the TBR parameter list must contain the 
address of a QMPA specifying the queue 
entry into which the tables are to be writ- 
ten. The function code field (QMPCP) of 
QMPA must specify a write operation. The 
TER parameter list must also contain the 
address, subpool, and size of each table to 
be written. The last word of the TBR pa- 
rameter list must be zero. The TBR returns 
a Head TTR address which locates the begin- 
ning of the tables on disk. This TTR must 
be saved for subsequent retrieval of the 
tables. 

The initial write establishes disk data 
records for the tables for the duration of 
the associated queue entry (i.e. , until the 
entry is deleted). Therefore, further 
write requests must specify the Head TTR in 
the TBR parameter list. Before issuing a 
write request, the caller must retrieve any 
previously written tables to prevent their 
being overlaid by the new write request. 

If the request is for output of tables, 
(transferring from main storage to direct- 
access device) , the Head TTR (passed in the 
parameter list) is used to read the first 
table queue control record (TQCR) . If the 
Head TTR is zero, the assign routine, IEF- 
QASGQ, is called to assign space for a new 
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TQCR. The TQCR is a 17 6 -byte record con- 
taining a 4- byte forward-chain pointer and 
space for 43 TTRs. These spaces are filled 
in as the tables are written, using the 
assign routine to assign the TTRs, and the 
Read/Write routine , IEFQMRAW, to write the 
tables in 176-byte segments. If more than 
43 records are required to hold the tables, 
a new TQCR is chained to the first, and 
processing continues. The low-order byte 
of the last TTR used in writing the tables 
is set to * FF f (hexadecimal) to indicate 
end-of- tables. After these TTRs are 
assigned, they are used each time the table 
breakup routine is called to write tables, 
as long as the Head TTR is preserved by the 
caller. 
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Figure 23. Table Breakup Parameter List 

Once a queue entry has been deleted, a 
caller must issue another initial write re- 
quest (Head TTR is zero in the table brea- 
kup routine parameter list) to establish a 
new string of table data records. IEFSD514 
does not free table storage areas. 

In retrieving tables, the TBR parameter 
list must contain the address of an asso- 
ciated QMPA. The function code (QMPOP) 
field must specify a read operation. The 
TBR parameter list must also contain the 
Head TTR address. Sufficient space must be 
allowed for the TBR to return the new main 



storage address of each table, and the sub- 
pool and size of each table as specified 
when they were written by the TBR. 

If the request is for input (reading 
into storage) of tables, the first TQCR is 
read into storage using the Head TTR passed 
in the parameter list. The first record of 
the first table is read, using the first 
record in the TQCR. This record contains 
the size of the table and the number of the 
desired subpool. IEFSD514 issues a GETMAIN 
specifying the subpool and the amount of 
storage required for the table. The 
remainder of the table is then read into 
the storage obtained, using read/write rou- 
tine IEFQMRAw. Each table specified in the 
parameter list is processed in this manner 
until , FF" (hexadecimal), indicating end- 
of -tables, is found. As each table is read 
into main storage, the parameter list is 
updated with the main storage address of 
that table. When all tables have been 
read, control is returned to the caller. 
The address of the updated parameter list 
is returned in register 1. Tables are 
always written in the same sequence that 
they appear in the TBR parameter list, 
beginning with the Head TTR. They are 
retrieved, totally, in the same sequence; 
they cannot be read selectively. 



Reader/Interpreter 

MFT uses the MVT reader/interpreter (read- 
er) . However, because of job class, poss- 
ible MFT interlocks, and the capability of 
using transient readers, some modifications 
have been made to the MVT modules, and six 
new modules have been added. These modifi- 
cations and additions are described below. 

MFT allows as many as three input 
readers to execute concurrently with prob- 
lem programs and writers. Resident readers 
operate in previously defined reader parti- 
tions, and transient readers operate in 
problem program partitions large enough to 
accommodate them. Input stream data for 
the step being read is transcribed onto 
direct-access storage where it is held 
until execution of the associated job 
begins. Problem programs retrieve this 
data directly from the storage device. 

In MFT there are three types of system 
input readers: 

• Resident reader. 

• User- assigned transient reader. 

• System- assigned transient reader. 

Resident and transient readers may operate 
in the same system, provided no more than 
one system-assigned reader is specified, 
and the total number of readers does not 
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exceed three. The primary difference 
between the user- assigned and system- 
assigned transient readers is the manner in 
which the transient reader resumes opera- 
tion after it is suspended. 



RESIDENT READERS 

A resident reader operates in a partition 
designated as such at system generation (by 
replacing the job class identifier with R), 
or during system initialization or parti- 
tion definition (by specifying RDR for the 
job class identifier). A resident reader 
reads its input stream, enqueuing jobs 
until the input stream reaches end- of -file 
or until it is terminated by a STOP command 
entered for that partition. 

Note: The STOP command does not take 
effect until the current job is completely 
read. 



TRANSIENT READERS 

A transient reader operates in a problem 
program partition large enough to accommod- 
ate it. A transient reader can be ter- 
minated by issuing a STOP command or by 
reaching end-of-file, as can the resident 
reader. In addition, a transient reader is 
suspended when a job is enqueued either for 
the partition occupied by the reader, or 
for a small partition. (Note that this is 
possible only when a reader completes read- 
ing an entire job.) 



If a transient reader is started in a 
specific partition by including the parti- 
tion assignment in the START command, it 
always resumes operation in that same par- 
tition, and only when that partition be- 
comes free. This type of transient reader 
is referred to as user -as signed . If , S* is 
substituted for the partition number in the 
START command, the system assigns the read- 
er to anv available large problem program 
partition. This type of transient reader 
is called system- assigned . 



READER CONTROL FLOW 

After a START command is entered to activ- 
ate a reader, master scheduler routine XEE- 
CIR50 determines if the size of the 
requested partition is large enough, and 
posts the partition. Job selection routine 
IEFSD510 determines that a START command 
has been entered, and passes control to 
system task control (STC) syntax check rou- 
tine IEEVSTAR. The syntax check routine 
validates the syntax of the START command, 
builds job control language tables, and 
retrieves the reader cataloged procedure 



specified in the START command. Each read- 
er is assigned to an input device specified 
in the START command. Control is then 
passed to interface routine IEFSD533 which 
sets up an interpreter entrance list (NEL) 
for a reader. It also allocates job queue 
space for a transient reader by issuing a 
dummy WRITE macro instruction. Control is 
| then passed to linkage routine IEFSD537 
which issues a LINK macro instruction to 
reader initialization routine IEFVH1 to 
begin reading the input job stream ( Chart 
24-26). 

I when reader initialization routine 
IEFVH1 receives control, it reads its input 
stream using QSAM, and translates job pro- 
cessing information into convenient form 
fcr subsequent processing by an initiator 
and system output writer. Each job read in 
by the readers is converted into tables 
that are placed in the appropriate job 
class input work queue specified by the 
CLASS parameter on the JOB statement. One 
input work queue exists for each of the 
fifteen problem program job classes (A 
through 0) . 

For systems that include Multiple Con- 
sole Support (MCS) , the PARK field on an 
EXEC statement includes a command authority 
code. This code is included in the option 
list created by interface routine IEFSD533 , 
and placed in the interpreter work area 
(IMA) by reader initialization routine 
IEFVH1. This code is passed by the reader 
when it issues an SVC 34 due to a command 
read in the input stream. 

After the reader has completed reading a 
job, control passes to queue manager 
enqueue routine IEFQMNQQ which enqueues the 
job on the appropriate input work queue 
according to the PRTY parameter on the JOB 
statement (see "Queue Kanageroeiit" in this 
section) . 

Note ; If the reader is being used as a 
subroutine by a problem program, it does 
not enqueue the job on the input work 
queue, but returns control to the problem 
program passing the addresses of the JCT 
constructed for that job, and the £MPA 
associated with that input queue entry. 

If data is encountered in the input 
stream, control is passed to interpreter 
CPO routine IEFVHG to transcribe the data 
onto direct-access storage for later re- 
trieval by the problem program. If there 
is no space for the data, control passes to 
interpreter operator message routine 
IEFSD536 to issue a DISPLAY active command 
and a WTOR message. The operator replies 
with either •WAIT' or 'CANCELr. If •WAIT' 
is specified, the reader waits for space to 
become available. If "CANCEL 1 is speci- 
fied, the reader is canceled and a READER 



Job Management 61 



CLOSED message is issued. IEFSD536 then 
sets indicators which cause cleanup of the 
current job, and control to be passed to 
interpreter termination routine IEFVHN to 
terminate the reader. 

After a reader enqueues each job, con- 
trol passes to transient -reader suspend 
tests routine IEFSD532. This routine 
decides whether to 1) terminate the reader, 
2) suspend the reader, or 3) have the read- 
er continue reading the job stream. (The 
decision to suspend the reader would never 
be made if the reader is resident.) If the 
reader is to be terminated, control passes 
to termination routine IEFVHN. If the 
reader is to be suspended, control passes 
to transient reader suspend routine 
IEFSD530. Otherwise, control returns to 
job and step enqueue routine IEFVHH to con- 
tinue reading the job stream. 

Transient Reader Suspend Routine (IEFSD530) 

When a transient reader is suspended, tran- 
sient reader suspend routine IEESD530 
(Chart 29) writes the tables and work areas 
used by the reader onto the work queue data 
set (SYS1.SYSJCBQE). 

The routine closes the reader and proce- 
dure library. Data needed to restore the 
reader is temporarily saved in the inter- 
preter work area (IWA). The IWA is then 
written to the work queue data set. When a 
user- assigned transient reader is sus- 
pended, the address of the reader space on 
the work queue is placed in the partition 
information block (PIB) . When a system- 
assigned transient reader is suspended, the 
address of the IWA is placed in the master 
scheduler resident data area (IEFSD568). 
(See Appendix A for the format of 
IEFSD568.) The work queue data set is 
later used by transient reader restore rou- 
tine IEESD531 to restore the reader when 
the assigned partition becomes available 
after job termination. "No work" ECBs for 
problem program partitions are posted (see 
"Job Selection"), and suspend routine 
IEESD530 returns control to system task 
control. 

Transient Reader Restore Routine (IEFSD531) 

Once a partition is again free for the 
reader, transient reader restore routine 
IEFSD531 (Chart 30) receives control and 
issues a GETMAIN for the IWA, Local Work 
Area (LWA), reader DCB, and procedure 
library DCB. The direct-access device 
address of the IWA is retrieved from the 
PIB if a user- assigned reader is to be 
restored, or from the master scheduler 
resident data area, if a system-assigned 
reader is to be restored. The IWA is then 
read in from the job queue. The TIOT is 
read into storage and the TCB pointer is 



updated; other tables and work areas neces- 
sary to restore the reader are reset from 
the information saved in the IWA. The 
reader and procedure library DCBs are 
opened and the reader resumes operation to 
start reading at the point in the job 
stream where it was suspended. Control is 
then passed to interpreter routine IEFVHCB 
to continue reading the job stream. 



Initiator/Terminator (Scheduler) 

To provide independent scheduling, schedu- 
lers operate in any problem program parti- 
tion of sufficient size. A partition large 
enough to accommodate the scheduler is 
referred to as a "large partition." A par- 
tition not large enough to accommodate the 
scheduler is referred to as a "small parti- 
tion". Within a given large partition, a 
scheduler operates independently of schedu- 
lers in other large partitions. Because 
small partitions cannot accommodate the 
scheduler, they rely on large partitions to 
perform their initiation, allocation, and 
termination operations. Scheduling for 
small partitions is described in "Small 
Partition Scheduling" in this section. 



An MFT initiator (Chart 18) dequeues a 
job (entry) for its partition based on a 
job class designated for the partition. 
Once dequeued, the job is scheduled accord- 
ing to the information contained in the 
entry. 



During allocation and termination of 
each job step, the allocation and termina- 
tion routines place messages and output 
data set pointer blocks in a specified out- 
put queue. The queue entry is created by 
the reader /interpreter . (The output queue 
entry becomes input to an output writer 
when the job is completed.) 



An initiator functions as a control pro- 
gram for the scheduling process, using the 
allocation and termination functions as 
closed subroutines. The MFT initiator is 
composed of the following routines: 



Job Selection 

Small Partition 

Job Initiation 

Data Set Integrity 

Step Initiation 

Problem Program Interface 

Step Deletion 

ENQ/DEQ Purge Routine 

Alternate Step Deletion 

Job Deletion 
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JOB SELECTION (IEFSD510) 

The job selection routine (Charts 19-23) 
acts as the control routine for the MFT 
initiator. The routine is brought into all 
large problem program partitions by the 
master scheduler at system initialization, 
by the job deletion routine when a job has 
terminated, or by system task control when 
a writer has been scheduled for a small 
partition or a reader has been suspended. 



Joo selection first waits on a "nc work" 
ECB in the PIB. This ECB is posted com- 
plete by the command processing routines, 
the job deletion routine, system task con- 
trol, or the small partition module when a 
small partition needs scheduler services. 

When the "no work" ECB has been posted 
complete, the job selection routine checks 
the PIB to determine if a life-of-task 
(LOT) block exists (see Appendix A for a 
description of the LOT block). If not, it 
creates one for the task. 



Job selection then checks the PIB for a 
small partition information list (SPIL) 
pointer (see Appendix A for a description 
of SPIL). If one exists, scheduling is 
performed for the small partition by pas- 
sing control to IEFSD599. If no SPIL 
pointer exists, the PIB is checked to 
determine if the partition is involved in 
partition redefinition; if the partition is 
to be changed, the PIE is checked further. 
If a job is queued on the checkpoint/ 
restart internal queue it is processed; if 
a restart reader is pending, it is started. 
If neither exists, no further scheduling is 
allowed in the partition and the partition 
can be redefined. (See "Master Scheduler 
Task".) 



If the partition in which the initiator 
is operating is not part of a partition 
redefinition, a test is made for a pending 
Restart Reader command. If no command is 
pending, a test is made to determine if a 
system- task reader or writer is to be 
started. If a restart reader or a system- 
task reader or writer is to be started, 
control passes to system task control which 
initiates readers and writers. If a 
restart reader is being started, and a 
user-assigned reader had been rolled out of 
the partition, the PIB is marked 
accordingly . 



If no small partition is requesting ser- 
vice, no reader or writer is to be started, 
and the partition is not part of a rede- 
finition operation, a final check is made 
to determine if a START INIT command has 



been issued; if so, job selection attempts 
to dequeue work from the input work queue 
(see Figure 24) . If a STOP INIT command 
has been issued, the attempt to dequeue a 
job is bypassed. 



A threshold check is then made to deter- 
mine if enough logical tracks are available 
on SYS1. SYSJOBQE to start the initiator. 
If not, message IEF427I COMD REJECTED FOR 
INITIATOR "ident 1 - INSUFFICIENT QUEUE 
SPACE is sent to the operator and job 
selection again waits on the "no work" ECB. 

The job selection routine obtains 
storage for the job control table (JCT) and 
checks to determine if a job is queued on 
the checkpoint/re start internal queue. If 
a job exists, dequeue by jobname routine 
(IEFLOCDQ) is used to remove it from the 
hold queue for processing. If no job is on 
the internal queue, the routine then uses 
the queue manager dequeue routine 
(IEFQMDQQ) to obtain work from one of the 
input job queues according to the job class 
assignment of the partition. If work is 
found, IEFQMDQQ constructs a CSCB for the 
job and an I OB to be used when reading or 
writing the input queue. The CSCB is con- 
structed in the system queue area and the 
address of the CSCB is placed in the ICT. 
The address of the IOB is placed in QMGR1 
When a user accounting routine is supplied, 
the job selection routine sets the LCT 
fields LCTTMWRK and LCTTMWRK+U to zero. 
These fields are used in calculating the 
execution time of a job step. Job selec- 
tion then branches to job initiation rou- 
tine IEFSD511. 



If the search for work for the partition 
is unsuccessful (i.e., no work has been 
enqueued for any of the job classes 
assigned to the partition) tests are made 
to determine if a transient reader is to be 
restored in the partition or if a START 
command has been entered for a system- 
assigned transient reader. If so, system 
task control is called. If a reader is to 
be restored in the partition, job selection 
passes control to special entry point 
IEE534SD in system task control. 



Command Processing Services 

In response to system commands entered in 
the input stream or from a console, the 
command processing routines request a ser- 
vice by storing information in the PIE of 
the affected partition or in the master 
scheduler resident data area for START and 
SlOP commands issued for system-assigned 
transient readers and writers. The job 
selection routine recognizes these requests 
and takes one of the following actions: 
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• Inhibits further job scheduling for the 
partition in preparation for the pro- 
cessing of a DEFINE command. (The 
DEFINE command can be entered only from 
a console.) 

• Prevents execution of problem programs 
in large partitions in response to a 
STOP INIT command. 

• Passes control to system task control 
in response to a START reader or START 
writer command. 

• Schedules problem program execution in 
response to a START INIT command. 



ALLOCATION 




TERMINATION 



Figure 24. Scheduling a Problem Program in 
a Large Partition 



SMALL PARTITION SCHEDULING 

A partition is defined as "small" when its 
size is at least 8K bytes but less than the 
job scheduler generated for the system. 
Small partition scheduling is performed by 
an initiator in a scheduler-size partition 
at the request of small partition module 
IEFSD599 (IEFSD599 is described later in 
the topic "Small Partition Module"). The 
small partition is therefore temporarily 



dependent on a large partition while sched- 
uler services are being performed. Sched- 
uling for a small partition is independent 
of scheduling for other small partitions in 
the system. 

The small partition module interfaces 
with job selection module IEFSD510 to sche- 
dule a problem program , or with system task 
ccntrol to schedule a writer in a small 
partition. Communication between the small 
partition module and job selection or sys- 
tem task control is maintained through a 
small partition information list (SPIL) . 
(The format of a SPIL is shown in Appendix 
A.) 

Small partition module IEFSD599 requests 
the scheduling function by placing the 
address of a SPIL in the partition informa- 
tion block (PIB) of each scheduler -size 
partition in the system. Each time job 
selection is entered between jobs # the PIB 
is checked for a non-zero SPIL address. If 
the PIB contains a valid address, the SPIL 
is analyzed, the job class queues for small 
partitions are searched for work, and con- 
trol is passed to one of the following: 

• Job Initiation (IEFSD511) , if work has 
been found for a small partition. 

• Step Deletion (IEFSD515) , if a small 
partition is waiting for termination. 

• System Task Control (IEEVSTAR) , if a 
writer is to be started in the small 
partition. 

These routines perform the requested 
service in the large partition and use the 
SPIL to indicate their action to IEFSD599. 
When the requested service has been per- 
formed, these routines return to IEFSD510. 

Initiating a Problem Program 

As shown in Figure 25, initiation of a 
problem program in a small partition is 
performed by a large partition. If a small 
partition is waiting for work, job selec- 
tion module IEFSD510 dequeues a job from an 
input work queue that the small partition 
is assigned to service. The large parti- 
tion posts a completion code in field ECBA 
of the SPIL when initiation services have 
been performed. 

A completion code of one indicates that 
no work was found for the small partition. 
The small partition then waits on the ECB 
list in the SPIL. The posting of any of 
the listed ECBs causes the small partition 
to request initiation services. 

A completion code of zero indicates that 
initiation services have been performed and 
the problem program job step is ready to be 
executed. The small partition, using the 
allocate parameter list (APL) , moves the 
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Figure 25. Scheduling a Problem Program in a Small Partition 



task input/output table (TIOT) and life-of- 
task (LOT) block from the large partition, 
opens required DCBs, and establishes prob- 
lem program mode. (If the system has the 
storage protection feature, the protection 
key is set.) If the job has not been can- 
celed, control passes to the problem pro- 
gram, thus freeing the large partition to 
continue processing. 

Initiating a Writer 

As shown in Figure 26, if a writer is to be 
started in the small partition, small par- 
tition module IEFSD599 requests initiation 
of the writer by system task control. A 
large partition responds to the request by 
bringing system task control routine IEEVS- 
TAR into the large partition. IEEVSTAR 
initiates the small partition to the point 
of calling in the writer. IEEVSTAR then 
posts ECEA in the SPIL with a completion 
code of zero to indicate to IEFSD599 that 
initiation services have been performed, 
and the writer is ready to be executed. 
Small partition module IEFSD599, using the 
link parameter list (LPL) , moves the TIOT 



from the large partition to the small par- 
tition. ECBC in the SPIL is posted, thus 
freeing the large partition to continue 
normal processing. Problem program mode is 
established, the SPIL is freed , and control 
passes to the writer via an XCTL macro 
instruction. 

T erminating the Small Partition 

Vihen the job step is completed, or a writer 
is stopped, small partition module IEFSD599 
is brought back into the partition and 
entered at special entry point SMALLGC. A 
check is made to determine whether a sched- 
uler ABEND occurred. If it did, a message 
is issued to the operator with a completion 
code, and all CSCBs associated with that 
job are removed from the CSCB chain. Con- 
trol then passes to the normal entry point 
of IEFSD599. If no scheduler ABEND 
occurred, the SPIL is created , and a status 
bit is set indicating that termination ser- 
vices are requested. The small partition 
module then begins a search for a large 
partition to perform the job termination 
services or writer end-of-job processing. 
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Figure 26. Scheduling a Writer in a Small Partition 



After an initiator in a large partition 
has performed the termination services , 
ECBA in the SPIL is posted with a comple- 
tion code of two to indicate that job ter- 
mination has taken place. A check is made 
to determine if the small partition is 
involved in a redefinition operation. If 
it is, the small partition is made quies- 
cent. If the small partition is not asso- 
ciated with a redefinition operation, it 
requests additional services from an 
initiator in a large partition. 

Note: If the initiator in a large parti- 
tion performs step termination instead of 
job termination, the next step of the job 
in the small partition is scheduled before 
the initiator schedules a job into its par- 
tition, or before it performs scheduling 
services for another small partition. 

Small Partition Module (IEFSD599) 

Small partition module IEFSD599 (Charts 
05-08) is entered from the redefinition 
routines at system initialization or when a 
DEFINE command is issued or from the master 



scheduler. The module is entered at spe- 
cial entry point SMAILGC from the ABEND 
routines when a step has completed execu- 
tion. IEFSD599 first waits on a "no work" 
ECB located in the partition's PIB. When 
this ECB is posted complete, the PIB is 
checked to determine if a SPIL has been 
created. If not, one is created and an 
indicator is set in the PIB. The PIE is 
checked to determine if the partition is 
involved in a redefinition operation. If a 
redefinition is pending, the internal job 
queue of checkpoint/restart jobs is checked 
and any jobs on the queue are processed 
before the partition redefinition. If 
there is nothing on the internal job queue 
and redefinition is pending, assigned 
tracks are deleted, the SPIL is freed, and 
pending CSCBs are freed. The •DEFINE 1 ECB 
in the PIB is posted to indicate that the 
partition has been made quiescent, and a 
return is made to wait on the w no work" 
ECB. 

If no redefinition operation is pending, 
the PIB is checked to determine if a writer 
is to be started in the partition. If so, 
an indicator is set in the SPIL, assigned 
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tracks are deleted, and a request for 
scheduling is made to a large partition 
(described below). If a writer is not to 
be started, the STOP INIT bit in the PIB is 
checked. If this bit is on, assigned 
tracks are deleted, the SPIL is freed, and 
a return is made to wait on the 'no work* 
ECB. If the STOP INIT bit is not on, the 
PIB is checked for track assignment. If 
needed, tracks are assigned and indicated 
in the PIB. The SPIL is updated to indi- 
cate a request for initiation of a problem 
program. 

A request is made for a large partition 
to service the small partition based oh the 
contents of the SPIL. First, an exclusive 
ENQ macro instruction is issued to prevent 
concurrent service requests by small parti- 
tions. Interruptions are disabled to pre- 
vent interference with the address of the 
SPIL in the large partition's PIB. 
IEFSD599 then searches for a scheduler-size 
partition. The TCBs are tested for problem 
program status; when a scheduler- size par- 
tition is found, a determination is made of 
whether the small partition is involved in 
a DEFINE operation. 

If the small partition is involved in a 
DEFINE operation, the test for the large 
partition involved in a DEFINE operation is 
bypassed. If the small partition is not 
involved in a DEFINE operation, the large 
partition is tested to determine if it is 
involved in a DEFINE operation. If so, the 
large partition is bypassed and the TCB 
search is continued. 

The address of the SPIL is stored in the 
PIB of the large partition, thus constitut- 
ing a request. An indication is made when 
storing occurs. If a large partition is 
waiting on its 'no work* ECB (in its PIB), 
the large partition is posted and the large 
partition routine clears the SPIL addresses 
in the other large partition PIBs. When a 
large partition is posted, or all appli- 
cable TCBs are checked, interruptions are 
enabled. 

If no SPIL pointers were stored during 
the search, a DEQ macro instruction is 
issued (to allow other small partitions to 
make requests), and a WAIT macro instruc- 
tion is issued on a ■ dormant 1 ECB in the 
small partition" s PIB. (When later posted 
by the command processing routines, the 
small partition module will repeat its 
search). If at least one SPIL pointer was 
stored, a WAIT macro instruction is issued 
on ECBB in the SPIL. This allows a large 
partition, immediately upon recognition of 
the request, to post the ECB complete. The 
small partition module may then issue a DEQ 
macro instruction to release the SPIL 
pointer field so other small partitions may 
make requests. 



Next, a WAIT macro instruction is issued 
on ECBA (in the SPIL) to delay the small 
partition until the requested service has 
been performed. When ECBA is posted com- 
plete by the large partition, the comple- 
tion code is tested to determine the action 
which occurred. If the completion code is 
two, job termination occurred and return is 
made to the point of determining the DEFINE 
status of the small partition. If the com- 
pletion code is one, "no work* was found 
for the small partition and a return is 
made to WAIT on the ECB list in the SPIL. 
If the completion code is zero, the large 
partition is at the point of calling either 
the problem program or a writer. The large 
partition is waiting on ECBC (in the SPIL) 
to allow transfer of information into the 
small partition by the small partition 
module. 



If a problem program is to be initiated, 
IEFSD599 uses the allocate parameter list 
(APL) to move the TIOT and user parameter 
area into the small partition. It then 
posts ECBC (freeing the large partition) , 
and opens Fetch and/or JCBLIB DCBs if 
required. The partition is established in 
problem program protection mode. The SPIL 
is freed. If the program to be initiated 
is the DSDR processing step of a checkpoint 
restart, IEFSD599 uses the APL to move the 
TIOT and user parameter area into the small 
partition, and posts ECBC. The routine 
moves the job QMPA and the SYSCUT QMPA from 
the LOT to the CSCB, and bypasses opening 
the JOBLIB and FETCH DCBs. The routine 
also bypasses setting the storage protec- 
tion key but frees the SPIL. 

A check is made to determine if the job 
has been canceled. If so, an ABEND macro 
instruction is issued. If the job has not 
been canceled, an XCTL macro instruction is 
issued to call the problem program into the 
small partition (the problem program passes 
control to ABEND at completion of its 
execution) . 

ABEND recalls small partition module and 
enters at special entry point SMALLGC. The 
small partition protection key is changed 
to zero and a SPIL is created. A termina- 
tion request is indicated in the SPIL, and 
IEFSD599 begins the search for a large par- 
tition to service the request. 

If a writer is to be initiated, the con- 
trol flow is the same as described above in 
"Initiating a Writer*,. 



INITIATOR/TERMINATOR CONTROL FLOW 

There are no terminator routines that are 
unique to MFT; the modules used in MFT task 
termination are described in IBM System/360 
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I Operating Systems MVT Job Management a Pro- 
I gram Logic Manual a Form Y28-6660. 

In addition to IEFSD510 and IEFSD599, 
several other initiator routines are unique 
to MFT. These are described in the follow- 

ling paragraphs. Descriptions of the MVT 
allocation and step initiation routines 

I that have not been modified by MFT can be 
found in IBM System/360 Operating System; 
MVT Job Management , Program Logic Manual , 
Form Y28-6660. 



Job Initiation Routine (IEFSD511) 

Job initiation routine IEFSD511 issues a 
GETMAIN specifying subpool to obtain 
space for the system output class directory 
(SCD). The SCD is then read into the area 
and the contents of the SCD are used to 
initialize QMGR2 in the LOT block. (QMGR2 
is the queue manager parameter area which 
is used for referencing the output data 
set.) After QMGR2 has been initialized* 
the storage obtained for the SCD is freed. 
A GETMAIN is then issued to obtain storage 
for I0B2, the IOB used in conjunction with 
QMGR2. A GETMAIN is issued (specifying 
subpool 253) to obtain space for the step 
control table (SCT). The SCT is read into 
the area thus obtained. Job initiation 
then branches to data set integrity routine 
IEFSD541. 



Data Set Integrity Routine (IEFSD541) 

The data set integrity routine is entered 
only once per job, from job initiation rou- 
tine IEFSD511. It first determines whether 
data set integrity processing is reguired. 

If the JCT indicates a •failed 1 job or 
if there are no explicit data sets (DSNAME 
parameter in a DD statement) for the job, 
processing is bypassed and exit is made to 
step initiation routine IEFSD512. If data 
set integrity processing is required, the 
DSENQ table records are read from the job's 
entry in the input job queue (SYS1. 
SYSJCBQE). Duplicate DSNAMEs are elimi- 
nated from the table and each unique DSNAME 
is placed in a minor name list. The most 
restrictive attribute (exclusive or share) 
is chosen for each DSNAME placed in the 
minor name list. After this processing is 
complete, an ENQ supervisor list is con- 
structed which contains an entry for each 
DSNAME in the minor name list. Each entry 
is initialized with the following: 

• RET=TEST option of ENQ. 

• SYSTEM option of ENQ. 

• Attribute (E/S) of the corresponding 
DSNAME. 



• Address of the common major name 

•SYSDSN*. 

• Address of the corresponding DSNAME 

(considered the minor name) in the 
minor name list. 

The DSNAME (minor name) length is contained 
in the first byte of each DSNAME field in 
the minor name list. 

When the ENQ supervisor list is con- 
structed, the system is disabled and an ENQ 
supervisor call is issued against the list 
to test the availability of the DSNAMEs. 
If the DSNAMEs are available, the ENQ 
supervisor list is updated so that each 
entry reflects the RET=NCNE option of ENQ. 
A second ENQ supervisor call is issued 
against the list to reserve DSNAMEs for the 
job. The system is enabled and exit is 
made to step initiation routine IEFSD512. 



If the DSNAMEs are unavailable for the 
jot) (already reserved with conflicting 
attributes by other task(s) in the system), 
the operator is notified of the condition. 
In notifying the operator, the return code 
field of each entry in the ENQ supervisor 
list is tested for a non-zero setting. If 
the setting is non-zero, the associated 
DSNAME (minor name) is identified to the 
operator as unavailable. The operator is 
given the following reply options: 

• RETRY, in case the resources have been 
freed by the other task (s) (processing 
is delayed until the operator replies) . 

• CANCEL the job. 

If RETRY is entered by the operator, pro- 
cessing continues at the initial ENQ super- 
visor call to again test the availability 
of the DSNAMEs. The operator is again 
notified, and he can reply either RETRY or 
CANCEL. If the job is canceled by the 
operator, the "job fail* bit in the JCT is 
set and exit is made to step initiation 
routine IEFSD512. 

Step Initiation Routine (IEFSD512) 

Step initiation routine IEFSD512 first 
issues a GETMAIN specifying subpool 253 to 
obtain storage for an allocate register 
save area (ARSA) and an allocate parameter 
list (APL). The APL (Figure 27) is ini- 
tialized containing addresses of the LOT, 
JCT, and SCT, and two words of zeros. 

The step initiation routine checks the 
current step to determine if it is either 
the checkpoint/re start data set descriptor 
record (DSDR) processing step or the 
restart step. If the step is a DSDR pro- 
cessing step being scheduled for a small 
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partition containing less than 12K bytes, 
the PIB of the partition containing the 
step initiation routine will be tagged to 
indicate that the DSDR step is to execute 
in that partition. The step initiation 
routine will place the address of its TCB 
and PIB in the LOT and pass control to 
allocation via a LINK macro instruction. 
If the DSDR step is to be processed in a 
large partition, normal processing is 
continued. 
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Figure 27. 
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If the step is the restart step, the 
step initiation routine will pass control 
to partition recovery routine IEFSD518 via 
a LINK macro instruction. If the return 
code from IEFSD518 is a zero, normal pro- 
cessing is continued; if the return code 
from IEFSD518 is a four, the address of the 
LOT is placed in register 1 and control is 
passed to job selection IEFSD510 via an 
XCTL macro instruction. 

The step initiation routine then passes 
control to allocation via a LINK macro 
instruction. Allocation returns the 
addresses of a task input/output table 
(TIOT) list (which points to the TIOT) in 
the first word of zeros in the APL. On 
return from allocation, the return code is 
tested to determine if allocation was suc- 
cessful. If not, step initiation branches 
to alternate step deletion routine IEFSD516 
via an XCTL macro instruction. If alloca- 
tion was successful, the ARSA is freed, and 
the "step started" bit in the SCT is turned 
on. The address of the job's CSCB is 
stored in the APL (in the last word of the 
list). 

Step initiation then uses queue manager 
read/write routine IEFQMRAW to write the 
JCT and SCT back on the input queue. The 
disk addresses of the JCT and SCT are saved 
in the LCT. A GETMAIN specifying sub pool 
253 is issued for the table breakup routine 



(TBR) parameter list and register save 
area. The TBR parameter list is initial- 
ized with the address, size, and subpool 
specifications for the TIOT and LOT block. 
The TIOT and LOT are then written into the 
job's entry in the job queue, and the Head 
TTR is saved in the JCT. The storage 
obtained for the TBR parameter list and 
register save area, IOB1, and IOB2 is 
freed. The JCT is then written out. Step 
initiation then passes control to problem 
program interface routine IEFSD513 via an 
XCTL macro instruction. 



Problem Program Interface Routine 
(IEFSD513) 

The problem program interface routine pre- 
pares the partition for execution of the 
job step. A test is made to determine if 
scheduling was performed for a small parti- 
tion. If so, this routine tests its parti- 
tion^ PIB to determine whether a 
checkpoint/restart data set descriptor 
record (DSDR) is to be processed. If the 
DSDR step is to be processed, the SPIL 
pointer in the LOT is ignored; otherwise 
the address of the APL is placed in the 
SPIL, ECBA in the SPIL is posted to indi- 
cate that scheduling is complete, and a 
WAIT is issued on ECBC. This WAIT allows 
the small partition module to copy tables 
and work areas into the small partition. 
When the tables have been copied, ECBC is 
posted complete, and the interface routine 
frees all storage obtained for tables and 
work areas except for the LOT block, which 
is retained. The address of the LCT block 
is placed in register 1 and this routine 
passes control to job selection, IEFSD510, 
via an XCTL macro instruction. 

If scheduling was not performed for a 
small partition, a test is made to deter- 
mine if the job has been canceled. If so, 
exit is made by issuing an ABEND macro 
instruction. 

If the job has not been canceled, the 
LOT block is freed, the TIOT is moved to 
the lowest possible location (subpool 0) in 
the partition, and a GETMAIN macro instruc- 
tion specifying subpool 253 is issued for 
the user f s parameter list (UPL). The UPL 
(Figure 28) is initialized from the SCT. 
Another GETMAIN macro instruction (subpool 
253) is issued to create a register save 
area for the user"s problem program. If 
STEPLIB, JOB LIB,, and/or FETCH have been 
specified, their DCBs are created (but not 
opened) in subpool 253. The JCT, SCT, and 
APL are now freed, the STEPLIB or JOELIB 
and FETCH DCBs are opened, and the TICT is 
then moved to subpool 253. A single DCE is 
used for STEPLIB or JOBLIB, with STEPLIB 
overriding JOBLIB if both are present. 
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If the job being started in the parti- 
tion is a checkpoint/restart data set 
descriptor record (DSDR) processing job, 
the routine moves the DSDR step QMPAs to 
the CSCB. The routine bypasses opening the 
STEPLIB, JOBLIB, and FETCH DCBs and also 
bypasses setting the storage protection 
key. 
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Figure 28. User's Parameter List 

Note : The use of subpools, and the order 
in which control blocks and tables are 
created, moved, or deleted, follows a par- 
ticular sequence even though this handling 
occurs within different modules. This is 
done to prevent fragmenting main storage 
within the partition. 

After the TIOT has been moved to the 
highest available position within the par- 
tition, the task control block (TCB) is 
updated and the problem program - s protec- 
tion key is set (if the system has storage 
protection) . The problem program interface 
routine then passes control to the problem 
program via an XCTL macro instruction. 

Step Deletion Routine (IEFSD515) 

Step deletion routine 1EFSD515 is entered 
at the end of step execution to prepare the 
partition for continued execution of the 
job, to interface with the termination sub- 
routine, to prepare for the initiation of 
the next step, or to branch to job deletion 
if there are no more steps in the current 
job. When step deletion is entered, a 
check is made to determine whether the rou- 
tine was entered due to an AEEND with the 
scheduler in control. If so, a message is 
issued to the operator and all CSCBs are 
removed from the CSCB chain. Control 
passes to IEFSD510 . 

If an ABEND did not occur, the step 
deletion routine branches to ENQ/DEQ purge 
routine IEFSD598 via a BALR instruction to 
remove any control blocks which were 



enqueued, but not dequeued, by the problem 
program step. 

Step deletion then issues a series of 
GETMAIN requests to obtain storage for 
queue manager IOBs (IOB1 and ICB2) , a tem- 
porary QMPA, and a register save area and 
parameter list for the table breakup rou- 
tine. These blocks and tables are initial- 
ized and step deletion branches to queue 
manager table breakup routine IEFSD514, to 
read in the TIOT and LOT blocks for the job 
step. The addresses in these blocks are 
restored and the storage obtained for the 
temporary work areas is freed. 

A GETMAIN (subpool 253) is issued to 
obtain storage for the SCT and JCT. The 
SCT is read into storage from the job 
queue, the JCT from its temporary area. 
The JCT is updated with the address of the 
next SCT and written back on the job queue. 
Storage is obtained for a terminate regis- 
ter save area and a terminate parameter 
list. The terminate parameter list is ini- 
tialized with addresses of control blocks 
(LOT, JCT, SCT, and TICT list) and the step 
deletion routine branches to the termina- 
tion subroutine via a BALR instruction. 
When termination returns control, step 
deletion frees the terminate register save 
area and terminate parameter list and then 
checks the return code. If the partition 
was executing the DSDR step for a small 
partition, step deletion places the 
addresses of the small partition's TCB and 
PIB in the LOT. 

If the return code indicates that the 
job is to be suspended, step deletion 
passes the address of the LOT block in reg- 
ister one to job suspension module IEFSD168 
via a BALR instruction. If the return code 
indicates that job termination was entered, 
step deletion branches to job deletion rou- 
tine IEFSD517. If job termination was not 
entered, the SCT for the next step of the 
job is read from the job queue, and step 
deletion passes control to IEFSD512 via an 
XCTL macro instruction. 

Note : If a small partition is requesting 
termination, entry to the step deletion 
routine is made at special entry point SMA- 
LTERM. Entry at this point causes pointers 
to the SPIL and the small partition f s TCB 
tc be established before the step deletion 
routine invokes ENQ/DEQ Purge routine 
IEFSD598. 



ENQ/DEQ Purge Routine (IEFSD598) 

At job termination, this routine purges all 
ENQ/DEQ control blocks associated with the 
TCB address passed in Register 4 by the 
caller. If step termination was completed 
instead, this routine purges all ENQ/DEQ 
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control blocks except the data set integri- 
ty blocks associated with the major name 
SYSDSN. 

When a given resource is dequeued for 
the subject TCB, a task switch may occur 
for a higher priority requestor whose wait 
count becomes zero, due to availability of 
the resource. (This purge routine operates 
in a disabled state to prevent concurrent 
updating of the ENQ/DEQ control blocks.) 



Alternate Step Deletion Routine (IEFSD516) 

Alternate step deletion routine IEFSD516 is 
entered from step initiation routine 
IEFSD512 when allocation for a step has not 
been successful. Using the APL and ARSA 
(created by the step initiation routine) as 
the terminate parameter list and terminate 
register save area, this routine branches 
to termination subroutine IEFSD22Q via a 
BALR macro instruction. When control is 
returned from termination, the storage used 
for the parameter list and register save 
area is freed and a test is made to deter- 
mine if job termination was entered. If 
so, this routine branches to job deletion 
routine IEFSD517 . If job termination was 
not entered, the SCT for the next job step 
is read from the job queue and this routine 
branches to step initiation routine 
IEFSD512. 

Job Deletion Routine (IEFSD517) 

The job deletion routine is called at job 
termination to delete the job from the 
input queue and to prepare the partition 
for initiation of the next job. The rou- 
tine sets the high-order byte of the 
LCTTCBAD field of the LCT to * 80" (hexade- 
cimal) to indicate to the ENQ/DEQ purge 
routine that it is job termination instead 
of step termination. The routine then 
branches to ENQ/DEQ purge routine IEFSD598 
to purge the control blocks. On return 
from the purge routine, the high-order byte 
is reset to •OO" . 

The job deletion routine then deletes 
the job from the input queue, using queue 
manager delete routine IEFQDELQ. All areas 
of storage in the partition which were used 
for the job (except the LOT block) are 
freed, and the job's CSCE is freed by issu- 
ing an SVC 34. The PIE fields used for the 
disk address of the TIOT and the LOT block 
are set to zero. If termination was for a 
small partition, ECBA in the SPIL is posted 
with a code of two (indicating job termina- 
tion for the small partition). If termina- 
tion was for a large partition (or after 
ECBA has been posted) the "no work" ECB in 
the PIB is posted and the job deletion rou- 
tine branches to job selection routine 
IEFSD510. 



Partition Recovery Routine (IEFSD518) 



Partition recovery routine IEFSD518 deter- 
mines the location of main storage required 
for a checkpoint restart. If the partition 
being scheduled for the job to be restarted 
contains the required main storage, the 
routine returns to the step initiation rou- 
tine for normal processing. If the nucleus 
has expanded past the lower boundary of the 
partition containing the required main 
storage, the routine sets the job fail bit 
in the JCT, issues a message stating that 
main storage is not available for the job, 
and returns to the step initiation routine 
IEFSD512 with a return code of zero. 

If the partition being scheduled does 
not contain the required main storage, the 
routine places the job on the hold queue , 
updates the SCD and places the SCD back on 
the job queue. The job"s CSCB is unchained 
and the space containing the CSCB and the 
ECB/IOBs is freed. The routine then 
branches to ENQ/DEQ purge routine IEFSD598. 

Upon return from ENQ/DEQ purge routine, 
if a problem program partition exists that 
contains the required main storage, this 
routine will create an internal queue ele- 
ment and chain it to the partition's PIB. 
Ihe partitions "no work" ECB will be post- 
ed and a message will be issued stating 
that the job will start in the partition. 
If an existing partition contains the 
required main storage and is defined as a 
reader or writer partition, this routine 
issues a message indicating that the parti- 
tion must be redefined to accept the 
desired jobclass. If no partition contains 
the required main storage or the partition 
that contains the required main storage is 
about to be redefined, this routine issues 
a message stating the length and displace- 
ment of the required main storage. If the 
partition being scheduled was a large par- 
tition its no-work ECB is posted; if it was 
a small partition, the SPIL is posted indi- 
cating job termination. The partition 
recovery routine frees the JCT and SCT 
areas of the partition and returns control 
to step initiation routine IEFSD512 with a 
return code of four. 

Dequeue by Jobname Interface Routine 
(IEFSD519) 

Dequeue by jobname interface routine 
(IEFSD519) builds a parameter list used by 
dequeue by jobname routine IEFLOCDQ to loc- 
ate a job named on the checkpoint/restart 
internal job queue. When a checkpoint/ 
restart job is indicated by an entry in the 
internal job queue pointer in the PIB being 
processed by job selection routine 
IEFSD510, job selection branches to 
IEFSD519 which builds the seven-word param- 
eter list required by IEFLCCDQ. When the 
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job is dequeued, IEFLOCDQ returns control 
to IEFSD519. 

The interface routine marks the job as 
ready and returns to job selection with a 
code of zero in register 15, indicating 
that the job has been found, and a pointer 
to the LCT in register 1. If the job is 
not found by IEFLOCDQ, a return code of 
four is returned in register 15 to job 
selection. (A description of IEFLOCDQ is 
in IBM System/360 Operating System; MVT 
Job Management, Program Logic Manual , Form 
Y28-6660.) 



System Output Writers 

MFT uses the MVT system output writer 
(Charts 31-32) with minor changes to five 
of the modules. As in MVT, the user may 
have up to 36 system output writers operat- 
ing concurrently in the system. Each out- 
put writer can handle eight output classes; 
output classes may be shared by writers. 
However, in MFT, system output writers are 
classified as either resident or non- 
resident. A resident writer operates in 
its own partition. A non-resident writer 
operates in any problem program partition 
large enough to accommodate it. 

RESIDENT WRITERS 

Resident output writer partitions are des- 
ignated in the TCB by a setting of * 10" in 
the first two bits of the pointer to the 
partition information block (P IB) . This 
designation is made at system generation by 
assigning W to the partition in place of 
the job class or by redefining a partition 
and assigning WTR to it. 

A resident writer is activated by issu- 
ing a START command specifying a partition 
designated previously as a writer parti- 
tion. A resident writer can be terminated 
only by issuing a STOP command specifying 
the device assigned to that writer. 



NON-RESIDENT WRITERS 

A non-resident system output writer may be 
started in a problem program partition 
large enough to hold the writer by issuing 
a START command specifying either that par- 
tition or by replacing the partition number 
with an 'S' .to specify a system-assigned 
non-resident writer. This causes a "com- 
mand pending" flag to be set in the parti- 
tion'' s PIB. 

When the writer has started, it executes 
in the same way as a resident writer and 
must be terminated by a STOP command to 
allow processing of problem programs to be 
resumed in the partition. 



SYSTEM OUTPUT WRITER MODULES 

The following five MVT system output writer 
modules are modified for MFT. 

• IEFSD070 - Data Set Writer Linkage 

Routine. 

• IEFSD079 - Linkage to Queue Manager 

Delete Routine. 

• IEFSD084 - Wait Routine. 

• IEFSD085 - Data Set Block (DSB) Handler 

Routine. 

• IEF SD 087 - Standard Writer Routine. 

Descriptions of all other system output 
writer modules can be found in IBM System/ 
360 Operating System: MVT Job Management , 
Program Logic Manual , Form Y28-6660. 

D ata Set Writer Linkage Routine (IEFSD070) 

This routine passes control to the appro- 
priate writer routine via a LINK macro 
instruction. The normal linkage is to the 
standard writer, IEFSD087. If a special 
user-written output writer routine is 
reguested, this routine passes control to 
that writer. Upon return from either writ- 
er, the routine passes control to data set 
delete routine IEFSD171 via an XCTL macro 
instruction which deletes the output data 
sets from the output gueue. 

Linkage to Queue Manager Delete Routine 
(IEFSD079) 

Upon completion of a job, linkage module 
IEFSD079 passes control to gueue manager 
delete routine IEFQDELQ via an XCTL macro 
instruction to delete all control blocks 
and SMBs associated with the output job 
from the job gueue. Following deletion, 
the routine then posts all reader ECEs that 
are waiting for space to indicate that 
space is now available. (The reader ECB 
chain address is obtained from the master 
scheduler resident data area.) When all 
ECBs have been posted, control is returned 
to main logic routine IEFSD082. 

Wait Routine (IEFSD084) 

This routine serves as a multiple WAIT when 
there is no work in any of the output 
classes associated with the writer. It 
issues a WAIT macro instruction on the ECB 
list created by class name setup routine 
IEFSD081. When the system output writer 
enters a wait state, the wait routine 
issues a message informing the operator 
that the writer is waiting for work. Any 
posting (such as a command, or work for the 
writer) causes control to be given to 
IEFSD082. 
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DSB Handler Routine (IEFSD085) 



System Task Control 



DSB handler routine IEFSD085 is the setup 
module for printing data sets. It issues a 
GETMAIN macro instruction for the input DCB 
if it was not obtained before, and con- 
structs a new TIOT containing an entry for 
the input data set. It also sets up any 
user-written output writer program. A 
check is then made to determine if a pause 
is required between data sets or only at 
forms change. If a special form is to be 
used, the routine writes a message to the 
operator telling him what form to put in 
the output device. The form change only 
occurs if the output device is unit record. 
This routine then passes control to linkage 
routine IEFSD070 via an XCTL macro instruc- 
tion. 



Standard Writer Routine (IEFSD087) 



This routine first issues an OPEN macro 
instruction to open the output data set. 
If the data set was not opened by the prob- 
lem program, no attempt is made to process 
the data set. After OPEN, a test is made 
to check for machine control characters. A 
switch is set that is interrogated by PUT 
routine IEFSD089. The writer then passes 
control to transition routine IEFSD088 
which creates header and trailer records. 
Upon return from IEFSD088, the writer rou- 
tine checks the CANCEL ECE in the CSCB to 
determine if a CANCEL command has been 
issued for this writer. If the CANCEL ECB 
has been posted complete, control passes to 
transition routine IEFSD088 to create a 
trailer record. When control is returned 
from IEFSD088, the writer is closed. Con- 
trol is then returned to linkage routine 
IEFSD078 via a RETURN macro instruction. 



If the writer is not to be canceled, the 
writer routine issues a GET macro instruc- 
tion to read a record and checks for a con- 
trol character. If no control character 
exists, the writer puts one in which causes 
the printer to skip one line or the punch 
to feed into the normal pocket. If the 
printer has overflowed, a skip is made to 
the next page. 



The writer then adjusts the pointer to 
the record so that it points to the first 
data character (instead of control charact- 
er) and passes control to transition rou- 
tine IEFSD088 for trailer records. It then 
issues a CLOSE macro instruction to close 
the input data set, a FREEPOOL macro 
instruction to free the buffers, and 
returns control to linkage module IEFSD078 
via a RETURN macro instruction. 



System task control (STC) (Chart 33) 
initiates all tasks except the initiator 
(S1ART INIT) . When the master scheduler 
determines that a START command with an 
identifier operand has been issued, it 
checks the validity of the partition speci- 
fied in the command, builds and chains a 
CSCB, places a pointer to the CSCB in the 
partition's PIB, and posts the partition. 

Note : If the procedure being started is 
for a system-assigned reader or writer, the 
CSCB pointer is placed in the master sched- 
uler resident data area. (See Appendix A 
for the format of the master scheduler 
resident data area). 

As shown in Figure 29, job selection 
module IEESD510 responds when the partition 
is posted,, and calls STC when a START com- 
mand for a reader or writer is recognized. 
If a reader or system output writer is to 
be started, STC must process a job descrip- 
tion similar to a user's job description. 
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Figure 29. Scheduling a Writer in a Large 
Partition 

The job description information for a 
reader or writer comes from three sources: 
the procedure library. Job Control lan- 
guage (JCIi) statements, and the operator. 
The procedure library contains standard 
descriptions of a reader and writer. JCL 
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statements (corresponding to input stream 
JCL) are stored internally; these state- 
ments invoke and modify the reader or writ- 
er procedure. The operator furnishes addi- 
tional information in the operand of the 
START command; this information is edited 
into the internally stored JCL statements 
before they are used to invoke and modify 
the procedure. 



in the form appropriate for the interpret- 
er. Each statement is built in an 88- 
character buffer (obtained with a GET MAIN 
macro instruction) . A pointer to the first 
buffer is placed in the CSCB associated 
with the START command. Each buffer con- 
tains a pointer to the next buffer, 4 bytes 
of reserved space, and a "card image" of 
the statement in the last 80 bytes. 



INITIATING SYSTEM TASKS 

When initiator job selection routine 
IEESD510 determines that a START command 
for a reader or writer has been entered, it 
passes control to START syntax check rou- 
tine IEEVSTAR via an XCTL macro 
instruction. 



START Syntax Check Routine (IEEVSTAR) 

The START syntax check routine gets main 
storage for, and builds, the start descrip- 
tor table (SDT) (see Figure 30). Seven 
entries are provided in the SDT: the first 
contains the JOB statement, the second con- 
tains the EXEC statement that calls the 
procedure specified in the START command, 
the remaining entries are provided for a DD 
statement and continuations of the EXEC and 
DD statements. Each entry contains a one- 
byte identification flags field, whose 
bits, when set to one, have the following 
meanings: 

• Bit indicates a JOB statement. 

• Bit 1 indicates an EXEC statement. 

• Bit 2 indicates a DD statement. 

• Bit 3 indicates a DD statement 
continuation . 

• Bit 4 indicates an EXEC statement 
continuation . 

• Bits 5 through 7 are reserved. 

The routine generates the JOB, EXEC, and 
DD statements that are placed in the SDT. 
The keyword parameters in the START command 
are compared with a list of keyword parame- 
ters that are allowable in a DD statement; 
they are not compared with DD subparame- 
ters. If the keyword corresponds to a 
member of the list, the routine stores it 
in the DD statement in the SDT. This DD 
statement overrides the IEFRDER DD state- 
ment in the procedure specified in the 
START command. If the keyword does not 
correspond to a member of the list, it is 
assumed to be a symbolic parameter keyword 
and is placed in the EXEC statement in the 
SDT. 

Finally, the Syntax Check routine passes 
control to the JCL Edit routine (module 
IEEVJCL), which builds the job ccntrol lan- 
guage set (JCLS). Using the information in 
the SDT, the JCL Edit routine puts the JCL 
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•Figure 30. START Descriptor Table (SDT) 



R eader Control Routine (IEEVRCTL) 

Reader control routine IEEVRCTL then 
receives control and builds the interpreter 
entrance list (NEL), option list, and exit 
list. The interpreter entrance list con- 
tains the address of the JCLS in its third 
word. The reader control routine passes 
control to the reader via a LINK macro 
instruction. 

The reader, used as a closed subroutine, 
is the same routine that performs the read- 
ing task. The non-zero value of the third 
word of the entrance list indicates that 
the input stream is an internal data set. 
Since the input stream is internal^ the 
reader issues a pseudo OPEN macro instruc- 
tion to bring a special access method (a 
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modified CSAM) into storage and places a 
pointer to the access method in the input 
DCB. This special access method reads the 
JCLS; it is entered from the expansion of 
the standard GET macro instruction. 

The internally- stored job control lan- 
guage statements, and the statements from 
the procedure library are analyzed and com- 
bined. The standard job description tables 
are built, and an input queue entry is con- 
structed; however, because bit 7 of the 
option switches field of the option list is 
off, the entry is not enqueued, and the 
reader or writer "job" cannot be selected 
by an initiator. If errors are detected 
during reader processing, appropriate mes- 
sages are placed in system message blocks, 
which are enqueued in the message class 
queue. When processing is complete, the 
reader places the main storage address of 
the job control table (JCT) in the NEL and 
returns control to the reader control rou- 
tine with a code that indicates whether 
processing was successful. The reader con- 
trol routine then passes control to alloca- 
tion interface control routine IEEVACTL. 



Allocation Interface Control Routine 

(IEEVACTL) 

The reader control routine passes control 
to allocation interface control routine 
IEEVACTL, with an indication of whether the 
reader had encountered errors. The alloca- 
tion interface control routine uses error 
message routine IEEVMSG1 to issue the WTO 
macro instruction to inform the operator of 
any errors that have been found. The rou- 
tine then constructs the required allocate 
parameter list, and passes control to the 
I/O device allocation routine via a LINK 
macro instruction. 



W rite TIOT on Disk Routine (IEESD590) 

Write TIOT on disk routine IEESD590 checks 
that a reader has not been started in a 
small partition, writes the TIOT which is 
used for job selection, and checks for a 
small partition writer. If a writer is to 
be started in a small partition, this 
module issues a POST macro instruction and 
a WAIT macro instruction for the SPIL and 
then passes control to job selection rou- 
tine IEFSD510 via an EXIT macro instruc- 
tion. If it is not for a small partition 
writer, control is transferred to linkor 
routine IEESD591. 



Linkor Routine (IEESD591) 



The linkor routine passes control to the 
requested routine via a LINK macro instruc- 
tion. When the reader or writer stops, it 
returns control to the linkor routine, 
which checks for a small partition writer. 
If a small partition writer returned con- 
trol to the linkor routine, control then 
passes to IEFSD510. If a resident reader 
or large partition writer returned control , 
termination interface routine IEEVTCTL is 
given control via an XCTL macro instruc- 
tion. If a transient reader was suspended, 
IEFSD591 returns to job selection routine 
IEFSD510. 

POST Routine (IEESD592) 

POST routine IEESD592 checks the CSCB to 
determine if it has been freed; if not, it 
is freed. It also checks for a small par- 
tition. The valid condition is posted in 
the SPIL or the PIB. The post routine then 
passes control to IEFSD510 via an EXIT 
macro instruction. 



I/O device allocation routine IEFSD21Q 
uses the JCT to find the appropriate tables 
in the input queue, allocates the necessary 
devices to the reader or writer, and issues 
any necessary mounting messages. The allo- 
cation recovery routines issue WTO macro 
instructions to inform the operator of any 
errors found during allocation. When allo- 
cation is complete, or if allocation cannot 
be performed, control is returned to the 
allocation control interface routine. 



Allocation control interface routine 
IEEVACTL determines if the routine to be 
given control is an authorized routine and 
then transfers control to Write TIOT rou- 
tine IEESD590. 

Note : A list of "authorized" routines is 
contained in a table in link-table routine 
IEEVLKNT . 



System Restart 

The system restart functions may be 
requested at any time that a system restart 
becomes necessary; e.g., end-of-day, end- 
of-shift, system malfunction, power fail- 
ure. This feature provides a means whereby 
a maximum amount of information concerning 
input work queues, output work queues, and 
jobs in interpretation, initiation, execu- 
tion, or termination can be preserved. 
System restart permits reinitialization, 
rather than a complete reformatting, of the 
job queue data set (SYS1.SYSJCBQE) . 



MFT uses the MVT system restart modules. 
For a complete description of these 
modules, and how they function, see IBM 
System/360 Operating System; MVT Job Man- 
agement, Program Logic Manual , Form Y28- 
6660. 



Job Management 75 



Appendix A: Tables and Work Areas 



This appendix contains descriptions and format diagrams of the major tables and work 
areas that are used by MFT job management . The tables and work areas are in alphabetical 
order, as shown below: 

• Command Scheduling Control Block (CSCB) 

• Data Set Enqueue (DSENQ) Table 

• Interpreter Work Area (IWA) 

• Job Control Table (JCT) 

• Job File Control Block (JFCB) 

• Job File Control Block Extension (JFCBX) 

• Lif e-of-Task Elock (LOT) 

• Linkage Control Table (LCT) 

• Master Scheduler Resident Data Area 

• Partition Information Block (PIB) 

• Small Partition Information List (SPIL) 

• Step Control Table (SCT) 

• Step Input/Output Table (SIOT) 

• Task Input/Output Table (TIOT) 

Tables and work areas are shown four or eight bytes wide for convenience, but are not 
necessarily drawn to scale. Tables that are stored in work queue entries are limited, by 
convention, to a length of 176 bytes. 

The names of most fields are sufficient to describe the fields; those that require 
further explanation are described in the text accompanying the table. Where a macro 
instruction may be used to include a DSECT of a table in routines using the table, the 
name of the mapping macro instruction is also given. The displacement of each field is 
shown to the left of each table; the values in parentheses show the hexadecimal 
displacement. 

COMMAND SCHEDULING CONTROL ELOCK (CSCB) 

Description : A command scheduling control block (CSCB) (Figure 31) is an area for 
communications between the command scheduling routine (SVC 34) and the command execution 
| routines. Input CSCBs are created by several system routines. When an input CSCB is 
created, it is placed in a chain of CSCBs by the command scheduling routine. It remains 
in the chain until it is deleted from the chain by the command scheduling routine, which 
may also free the main storage occupied by the CSCB. An input CSCB is created under the 
following circumstances : 

• A CSCB is created by the command scheduling routine each time a task-creating command 
is encountered. If the task is a reading or writing task, the CSCB is deleted from 
the chain, and its main storage released, when the task terminates. 

• A CSCB is created by the queue management dequeue routine each time the initiator 
dequeues a job. This CSCB is deleted from the chain, and its main storage released, 
when the last step of the job has terminated. 

• A CSCB is created by a system output writer each time it encounters a DSB that was 
not preceded by another DSE in the current queue entry. The CSCB serves as a 
communication area, allowing the cancelation (by operator command) of the subtasks 
established by the writer. The CSCB is deleted from the chain, and its main storage 
released, when the writer encounters an SMB (or the last block in the current queue 
entry) . 

A control CSCB is updated (and changed to the control format if necessary) by the 
command scheduling routine when a CANCEL jobname (job selected), CANCEL writer device, 
MODIFY, or STCP command is encountered. 

Although most of the fields are self-explanatory, the following require further 
description: 
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• Status Flags : This byte indicates the status (pending/not pending) of the CSCB f and 
the action to be taken by the command scheduling routine. In addition to command 
processing, the command scheduling routine may be entered to add the CSCB to the 
chain f delete it, free its main storage, or to branch to the abnormal termination 
routine. 

• Type Flags ; This byte indicates the type of activity with which the CSCB is 
associated. 

• Communication Flags : This byte indicates the function to be performed by the command 
processing routine. 

Mapping Macro Instruction : IEECHAIN 
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•Figure 31. Command Scheduling Control Block (CSCB) (Part 1 of 2) 
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Control CSCB 

•Figure 31. Command Scheduling Control Block (CSCB) (Part 2 of 2) 
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DATA SET ENQUEUE TABLE (DSENQ) 

Description ; The data set enqueue table (DSENQ) (Figure 32) is built by the DD statement 
processor routine of the interpreter, and is used by the initiator to construct an ENQ 
macro instruction parameter list to prevent routines performing different tasks from 
using the same exclusive data sets concurrently. The table contains an entry for each 
data set (except temporary data sets) required for a job. 



0(0) 



4(4) 



8(8) 



12(C) 



16(10) 



Queue Address of This DSENQ Table 



Table ID 



Queue Address of Last DSENQ Table 



Zeros 



Name of Characters in all DSNAME Entries to Date 



Number of DSNAME Entries 
to Date 



First DSNAME Entry* 



Last DSNAME Entry* 



Zeros - ■** 
End of DSENQ 



Exclusive/ 
Shared 



Length of 
DSNAME 



Data Set 



Name 



■X-* If the last entry uses the last available space in the tables but no overflow occurs, 
the zero bytes are omitted. 

Figure 32. Data Set Enqueue Table (DSENQ) 



INTERPRETER WORK AREA (IWA) 



| Description : The 2044-byte interpreter work area (IWA) (Figure 33) is obtained from 
subpool zero by a GETMAIN macro instruction in the interpreter initialization module 
(IEFVH1). The IWA contains information used by the interpreter routines; it is the area 
in which job description tables are built before they are placed in the work queues. 

Although most of the fields in the interpreter work area are self-explanatory, the 
following require further description: 

• Default Parameters : The PARM field of the EXEC statement in the reader procedure 
contains parameters to be used when no explicit specification is made. These 
parameters specify whether the installation requires a programmer's name or account 
number on each JOB statement, the priority to be assigned to a job if no priority has 
been specified, whether commands in the input stream should be processed (or 
ignored), and the device, primary quantity, and secondary quantity to be allocated to 
system output data sets. 

| • Switches A- J : These fields contain internal switches used for communicating status 
information among the interpreter routines. 
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• Switch K : This field contains the Priority Change Value for the CHAP macro 
instruction . 

• Switch L : This field contains the Default Allocation level in MSGLEVEL. 

• Switch M : This field contains the Default JCL level in MSGLEVEL. 

• Switch N ; This field contains the length of the fixed part of the message for 
symbolic parameter substitution. 

• Switch XI ; This field is set to X'SO" for a search of the DDNAME reference table or 
to X'UO' for SYS0UT. 

• Checkpoint/Restart Switch : This field contains switches that communicate 
checkpoint/restart status information to the interpreter routines. 

• System Input Allocation Table : This area contains a list of pointers to the UCBs 
corresponding to units available for allocation to system input data sets. 

• Queue Address Table : This area contains the addresses (in TTR form) of the next two 
records assigned to the job's input queue entry, and the addresses (in TTR form) of 
the first joblib SIOT, the first scan dictionary record, and the DD override table. 

• Input Stream Parameter List : This area describes the statement last encountered in 
the input stream, and contains a pointer to the field currently being processed. 

• Procedure Library Parameter List : This area describes the statement last read from 
the procedure library, and contains a pointer to the field currently being processed. 

• Procedure Library Merge Control Data : This area contains information used in merging 
statements from the input stream with statements from the procedure library. The 
information includes the statement names, the step names, and the names of the 
previous and next procedure steps* 

Mapping Macro Instruction : IEFVMIWA 
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Part 3) 



(continued) 



• Figure 33. Interpreter Work Area (IWA) (Part 1 of 3) 
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(continued) 
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Address of PGM Referback Dictionary 



Address of QMPA 



Address of PROC Referback Dictionary 
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(continued) 
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Work Files 
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(continued) 



Figure 33. Interpreter Work Area (IWA) (Part 2 of 3) 
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(continued) 
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Intermediate Text Buffer 
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Current Register Save Area 



Address of DCB 



SYSIN Address during Rollout 



Text Key Address 
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Control Routine Work Area 



Reserved 
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Switch K 
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•Figure 33. Interpreter Work Area (IWA) (Part 3 of 3) 
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shown below: 
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JOB CONTROL TABLE (JCT) 

Description ; The job control table (JCT) (Figure 34) is created in the interpreter work 
area by the job statement processor routine of the interpreter. It contains information 
from the JOB statement, job status information, and pointers to other tables in the job's 
input queue entry. When the interpreter has processed all steps of a job, the JCT is 
written into the appropriate input queue according to priority; it is read back into main 
storage by the initiator job selection and job delete routines. 

Although most of the fields in the job control table are self-explanatory, the 
following require further description : 

• Job Status Indicators : The sixth byte of the JCT indicates the status of the job as 



A JOBLIB DD statement is included with the job 

Job flush 

Job step canceled by condition codes 

Step flush 

JCT ABEND 

Job failed 

Job includes a cataloged procedure 

Job is a "no setup" job 

Checkpoint/Res cart Indicators : This two byte field indicates the checkpoint/restart 
status as shown below: 



Meaning 

Warm start 

Not used by MFT 

Not used 

Checkpoint taken for this step 

Intra-step checkpoint/restart to be done 

Step restart to be done 

Must be set to zero 



Meaning 

SYSCHK DD statement is included with the job 

RD keyword parameter is not NC 

No restart is to be done 

No checkpoints are to be taken 

Do restart if necessary 

Not used 

DSDR processing has not successfully ended 

• SYSCUT Classes : The first 36 bits of the five-byte field are used to indicate the 
system output classes that contain data. The four remaining bits are reserved. 

Mapping Macro Instruction : IEFAJCTB 
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•Figure 34. Job Control Table (JCT) 
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Queue Address of Next JFCBX 
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82 



Reserved 



Job File Control Block Extension 

Figure 35. Jofc File Control Block (JFCB) and Extension (JFCBX) 
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JOB FILE CONTROL BLOCK (JFCB) AND EXTENSION (JFCBX) 

Description : A job file control block (JFCB) (Figure 35) is constructed in subpool zero 
(from information in a DD statement) by the interpreter DD statement processor routine. 
The JFCB is written into the job's input queue entry, and retrieved when a DCB with the 
corresponding name is opened. The information in the JFCB, which describes the 
characteristics of a data set, may be modified by the open routine. 

A JFCB contains enough space to record five volume serials. If more than five volume 
serials are specified, enough job file control block extensions (JFCBXs) to contain the 
additional volume serials are constructed; each JFCBX can contain up to fifteen 
additional volume serials . 

Additional information on the contents of the JFCB and JFCBX may be found in the 
publication, IBM System/360 Operating System: System Control Blocks , Form C28-6628. 

Mapping Macro Instruction : IEFJFCBN 

LIFE- OF- TASK (LOT) BLOCK 

Description : The 348-byte life-of-task (LOT) block (Figure 36) is built in a main 
storage area obtained from subpool 253. It stores information for scheduling functions, 
and is used by system task control and initiators. It is created by the Job Select 
module for initiating problem programs, and by system task control for initiating readers 
and writers. 

The LOT block contains the linkage control table (LCT) , a two-level register save area 
(REGSAVE), an input queue manager parameter area (QMGR1) , an output queue manager 
parameter area (QMGR2), the address of the ECB list, the address of the PIB, and the 
address of the SPIL. 

LINKAGE CONTROL TABLE (LCT) 

Description : The linkage control table (LCT) (Figure 37) is built in a main storage area 
obtained from subpool 253 by the initiator initialization routine. It is a 
communications area used by the routines of the initiator. 

Most of the fields in the LCT are self-explanatory; it should be noted, however, that 
the job termination status bit is the low-order bit of the one-byte device features 
field. 

Mapping Macro Instruction : IEFALLCT 

MASTER SCHEDULER RESIDENT DATA AREA 

Description : The master scheduler resident data area (Figure 38),, which is in the 
nucleus area of main storage, contains information used by the queue initialization, 
command scheduling, initiator, and I/O device allocation routines. Its location is 
stored in the CVTMSER field of the communication vector table. 

Most of the fields in the master scheduler resident data area are self-explanatory; 
those fields that require further explanation are described below: 

• Queue Formatting Switch : If the high-order bit of this field is on, it indicates 
that the queue data set must be formatted. 

• Transient Reader TTR : This field is used by the transient reader suspend routine to 
store the address of the work queue data set where the reader information was placed 
when the reader was suspended. 

• DEFINE Control Information : If the high-order bit of this field is on, it is a 
DEFINE operation; if off, it is IPL time. The second bit indicates that a list of 
the partitions 1 sizes and job class (es) has been requested; the third bit indicates 

I that there is an adjacent partition check; the fourth bit is set when initialization 
I is complete to allow DEFINE commands to be accepted; the fifth bit is set on when the 
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operator has requested partition changes at IPL; the sixth bit indicates that a small 
partition cannot terminate because of the DEFINE operation; the seventh bit indicates 
that a DEFINE command has been issued during operation; the eighth bit indicates that 
the system has storage protection. 



• Status Flags ; When set on f status flags indicate: 



Bit Meaning 

System Initialization in progress 

1 DISPLAY JOBNAMES 

2 Reserved 

3 VARY/UNLOAD summary 

4 Queue hold-release 

5 DISPLAY ACTIVE processing 
6-7 Reserved 
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Figure 36. Life-of-Task (LOT) Block 
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Address of Current SMB 
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Serials to Passed Data Set Volumes 
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16 
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96 (60) 


4 
JOBLIB DCB Address 


4 
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•Figure 37. Linkage Control Table (LCT) 

• Log Status Flags : 

Bit Meaning 

Log Data Set Sysout Scheduling 

1 Log Threshold Reached 

• MFT Switches : When set on, flags indicate: 

Bit Meaning 

Transient Reader Active 

1 Transient Reader in Core 

2 Pending START command for transient reader 

3 MFT Environment switch 

4 System Assigned Reader is Running 

5 Core storage is in System 
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• Initialization Switches : When set on, flags indicate: 



Bit Meaning 

IPL switch 

1 SYSOUT IPL 

2 SYSOUT job start 
3-4 Reserved 

5 34 Security 

6 Queue initialized 

7 Procedure catalog initialized 



• Pending Flags ; When set on, flags indicate; 



Bit Meaning 

IPL Date 

1 Region busy 

2 Command move completed 

3 Interpreter command return 

4 System Input control purge request 

5 System output control purge request 

6 Blank start pending (REQ=1, START BLANK=0) 

7 Console command suppressed by WTO/WTOR Exit Routine 



• ECB Flags : When set on, flags indicate: 



Bit Meaning 

External interrupt 

1 WTO or WTOR 

2 WTL 

3 Console Attention key hit 

4 System Input 

5 System Output 

6 Master command routine 

7 Summary bit, Vary UCB scan required 



• Resident Switches : When set on, switches indicated: 



Bit Meaning 

IPL has been completed 

1 WTO or WTOR pending 

2 Console usage. Primary or alternate 

3 Log purge request 

4 Reader has reached end of file, or Start reader 

5 New reader pending 

6 New writer pending 

New writer pending (Modify) 

7 Job notification (l=yes) 

• Fetch Flags : When set on, flags indicate. 

Bit Meaning 

Named Fetch 

1 Defer current command execution sequence 

2 TCB Tree Trace Fetch (Locate) 

3 Auxiliary FETCH given 

4 Reply bit to Request attention 

5 Pseudo-SYSOUT flag 

6 DISPLAY STATUS 

7 Queue hold-release 

• Mapping Macro Instruction : IEEBASEB. 
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•Figure 38. Master Scheduler Resident Data Area (Part 1 of 2) 
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•Figure 38. Master Scheduler Resident Data Area (Part 2 of 2) 



PARTITION INFORMATION BLOCK 



The 40- byte partition information block (PIB) (Figure 39) contains information used by 
the command processing and scheduler routines. Its location is stored in the TCBPIB 
field at displacement 124 (decimal) of the task control block (TCB). 

Although most of the fields in the partition information block are self-explanatory, 
the following require further description: 

• ECB Address : Contains the address of ECB to be posted by job selection when the 
partition is made quiescent for partition redefinition. 

• w No Work" ECB for the Initiator : This ECB is posted by small partitions requesting 
service, the queue manager when a job has been enqueued, and by the DEFINE and START 
command routines. 

• Status A Information : 

Bit Setting Meaning 

Stop initiator 

1 START INIT issued 

1 1 Partition active 

2 1 Pending command 

3 1 Transient reader operating 

4 1 Partition is to be terminated by IEFSD599 when it next gets 

control 

5 1 Partition is involved in redefinition 

6 1 System-assigned transient reader operating in this partition 

7 1 Problem program is running 
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• Status B Information: 



Bit Setting Meaning 

1 Logical tracks added for initiator 

1 1 LOT block exits 

2 1 SPIL has been created 

3 1 Reserved 

4 1 Unending task present in partition 

• SPIL Address : The small partition information list (SPIL) is applicable to large 
partitions only, 

• Job Class Codes : Contains one to three codes for the partition, arranged in 
descending numerical order, i.e., GRP3 is in the second byte of the field, followed 
by GRP2 and GRP1. The first byte contains the protection key for the partition, if 
the system has the storage protection feature. 

• Internal Queue Status Bits : 

Bit Setting Meaning 

1 A large partition in which the DSDR processing step for a 

small partition (less than 12K) is to be executed 

1 1 A restart reader has been started in place of a user 

assigned reader 

2 1 A DEFINE command has been received and the partition is 

processing jobs on its internal gueue. 
3-7 Reserved 



0(0) 




CSCB Address of Pending Command 


4 


4(4) 




ECB Address 


4 


8(8) 




"No Work" ECB for the Initiator 


4 


12(C) 


1 




3 




Status Bits - A 


Address of Current Job Step CSCB 




16(10) 


1 




3 




Status Bits - B 


SPIL Address 




20 (14) 




CSCB Address of Current Task in Partition 


4 


24(18) 


1 




3 




Protection Key 


Job Class Codes 




28 (1C) 




CSCB Address of Suspended Reader 


4 


32 (20) 




Reserved 


4 


36 (24) 


1 




3 




Internal Queue 
Status Bits 


Address of Internal Queue of Job Names to be Restarted 





Figure 39. Partition Information Block (PIB) 
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SMALL PARTITION INFORMATION LIST (SPIL) 

Description : The 32-byte small partition information list (SPIL) (Figure 40) is a 
storage area for information pertaining to small partition scheduling. It is built in 
main storage obtained from subpool 0. The address of the ECBs provides for information 
to be passed between the small partition and the large partition that is performing 
initiation, allocation, or termination functions for the small partition. 

Most of the fields in the small partition information block are self explanatory; 
however, the status bits field is described below. 

Bits and 1 contain ones if a START writer command has been entered. 

Bit 2 contains a one if a SPIL pointer has been stored in the PIB. 

j Bit 3 contains a one if a problem program has requested termination. 

Bits 0-7 contain zeros if a START IN IT command was entered. 



0(0) 






(ECBA) 
Event Control Block 


4 


4(4) 






(ECBB) 
Event Control Block 


4 


8(8) 






(ECBC) 
Event Control Block 


4 


12(C) 






Address of Small Partition TCB 


4 


16 (10) 


Status 


1 
Bits 




Reserved 


3 


20 (14) 




Address of All 


Dcate Parameter List (In Large Partition) if a Problem Program; 
TIOT, if a Reader or Writer 


4 


24(18) 






Address of CSCB for Writer 


4 


28 (1C) 






Address of ECB List for Dequeue 


4 



Figure 40. Small Partition Information List (SPIL) 



STEP CONTROL TABLE (SCT) 

Description : The step control table (SCT) (Figure 41), is used to pass control 
information to the DD routine of the interpreter and to the initiator routines, which 
also contribute information to the table. This table is created and initialized by the 
execute statement processor routine of the interpreter when an EXEC statement is read. 
One SCT is created for each step of a job. 

If the step is part of a previously cataloged procedure, the name of the step that 
called the procedure, if any, is entered. The following variable-content and indicator 
fields are included in the table: 

BYTE 4: Internal Step Status Indicators : 

Bit Setting Meaning 

1 Step can be rolled out 

1 1 Roll step out if necessary 

2 1 Do not restart step 

3 1 Do not take a checkpoint 
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4 1 Restart if necessary 

5 1 Graphics - alter protect key 

6 1 Graphics - ABEND exit 

7 1 Step failed 

PARM Count or Step Status Code ; 

a. Interpreter : The number of characters specified in the PARM parameter of the 
EXEC statement is placed in this entry. 

b. Initiator : This table entry contains the condition code returned by the 
processing program. 

BYTE 67: Step Type Indicators : 

Bit Setting Meaning 

1 EXEC statement contains PGM=*.stepname.ddname 

1 1 SYS IN is specified as DD* 

2 1 SYSOUT is specified 

3 1 JFCB housekeeping is complete 
4-7 Reserved 

BYTE 104: Step Status 

Bit Setting Meaning 

0-1 Reserved 

2 1 SCTMCVOL 

3 Reserved 

4 1 SCTSTPLB 
5-7 Reserved 

Mapping Macro Instruction : IEFASCTB 



STEP INPUT/OUTPUT TABLE (SIOT) 

Description : The Step Input/Output Table (SIOT) (Figure 42), makes DD statement 
available to the initiator for use as a source of information for the TICT and for 
providing DD information to allocation and disposition routines. When a DD statement is 
read, the interpreter creates a new SIOT and places the DD information into it. The 
individual bits of the disposition byte and of indicator bytes 56 through 59 in the SIOT 
are set to one to indicate the following conditions: 

BYTE 55: Scheduler Disposition 

Bit Meaning 

Reserved 

1 Retain volume 

2 Private volume 

3 Pass data set 

4 Keep data set 

5 Delete data set 

6 Catalog data set 

7 Uncatalog data set 

BYTE 56: Indicator Byte Number 1 

Bit Meaning 

Dummy data set 

1 SYSIN data set 

2 Split (primary) 

3 Split (secondary) 

4 Suballocate 

5 Parallel mount 

6 Unit affinity 

7 Unit separation 
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(0) 



(8) 



16 (10) 



24 (18) 



32 (20) 



40 (28) 



48 (30) 



56 (38) 



64 (40) 



72 (48) 



80 (50) 



88 (58) 



96 (60) 



104 (68) 



112 (70) 



120 (78) 



160 (A0) 



168 (A8) 



3 

Queue Address of SCT 


1 

Table ID 
(02) 


Internal 
Step Status 
Indicators 


3 
Maximum Step Running Time 


2 
PARM Count or Step Status 
Code at Termination 


2 

Length of Allocate Work 
Area, or Number of SIOTs 


3 
Queue Address of First SIOT Entry 


1 

Reserved 


3 
Queue Address of Allocate Work Area 


1 
Reserved 


3 
Queue Address of Next SCT 


1 
Reserved 


3 
Queue Address of First SMB 
for Next Step 


1 
Reserved 


3 
Queue Address of Last SMB 
for This Step 


1 
Reserved 


3 
Queue Address of First ACT Entry 

for This Step 


1 

Reserved 


3 
Queue Address of VOLT 


1 
Reserved 


3 
Queue Address of Dsname Table 
for This Step 


1 
Reserved 


Name of Step That Called Procedure 


8 
Name of Step That Called Procedure (Continued) 


Step Name 


8 
Step Name (Continued) 


2 
Relative Pointer to 
Step Entry in ACT 


2 
Length of VOLT 


Number of 
SIOTsin 
This Step 


Number of 

Setup 

Messages 


Number of 
JFCBs to 
Allocate 


1 
Step Type 
Indicators 


4 
Queue Address of SCTX 


1 
X'00' 


3 
Hierarchy 
Region Address 


1 
X'01' 


3 
Hierarchy 1 
Region Address 


8 

Reserved 


2 
Hierarchy 
Region Size 


2 

Hierarchy 1 
Region Size 


2 

Reserved 


Step Dispatching ^ 

Priority 

(MVTonly) 


4 
Step SYS IN count for SMF 


4 
Queue Address of PGM = *, 
stepname, ddname SIOT 


Extension 1 
of Internal 
Step Status 
Indicators 


3 
Queue Address of 
the Step TIOT 


4 
Program Name 


8 

Program Name (Continued) 


2 

Length (in Bytes) of 
Dsname Table for This Step 


2 
First Step Condition Code 


First Step 
Condition 
Operator 


3 
Queue Address of First Condition SCT 


36 


— Second Through Sevent 


h Step Condition Entries 


2 
Eighth Step Condition Code 


Eighth Step ] 

Condition 

Operator 


3 
Queue Address of Eighth Condition SCT 


2 
Reserved 


3 
Queue Address of the First 
DSB in Message Class 


Number of 1 
Message 
Class DSBs 
for this Step 


1 
Step 
Status 


3 
Queue Address of 
Last Legitimate SMB 



176 (B0) 

•Figure 41. Step Control Table (SCT) 
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BYTE 57: Indicator Byte Number 2 



Bit Meaning 

Channel affinity 

1 Channel separation 

2 Volume affinity 

3 JOBLIB DD statement 

4 Unlabeled (no labels) 

5 Pool DD statement 

6 Defer mounting 

7 Received data set 



BYTE 58: Indicator Byte Number 3 



Bit Meaning 

Volume reference 

1 SYSIN expected (procedures only) 

2 Allocate work table volume block indicator 

3 Volume reference in step 

4 SYSOOT was specified 

5 NEW data set 

6 MOD data set 

7 OLD or SHR data set 



BYTE 59: Indicator Byte Number 4 



Bit Meaning 

Set by reader to indicate GDG single 

4 Step processed 

5 Intra -step volume affinity 

6 Data set is in passed data set queue (PDQ) 

7 1 = old or modified data set 
= new data set 

BYTE 92: Conditional Disposition 

Bit Meaning 
0-3 Reserved 

4 Keep data set 

5 Delete data set 

6 Catalog data set 

7 Uncatalog data set 



Mapping Macro Instruction : IEFASIOT 



TASK INPUT/OUTPUT TABLE (TIOT) 

Description : The Task Input/Output Table (TIOT) (Figure 43) provides data management 
routines with the addresses of the JFCBs and devices allocated to the data sets in a job 
step or system task. It is constructed by the I/O device allocation routine in main 
storage obtained from subpool zero. The allocation routine also places a copy of the 
TIOT on the appropriate job class queue with the other tables for the job step. After 
the step completes processing, the TIOT is brought in from the job queue and placed in 
the upper portion of the partition. The step is then terminated, and the TIOT is 
deleted. 

For further information on the TIOT, see IBM System/360 Operating System: System 
Control Blocks , Form C28-6628. 
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0(0) 


3 
Queue Address of SIOT 


1 
Table ID 


4(4) 


8 
DD Name 


12(C) 


8 
Channel Separation and Affinity 


20 (14) 


8 
Unit Separation and Affinity 


28 (1C) 


3 
Queue Address of Next SIOT 


1 
Reserved 


3 
Queue Address of JFCB 


1 
Reserved 


36 (24) 


3 
Queue Address of SIOT 
for VOLREF or SUBALLOC 


I 
Reserved 


3 
Queue Address of SIQT System 
Output/Dependency Block 


1 
Reserved 


44 (2C) 


3 
Queue Address of DD Name Table 


2 
Reserved 


Number of 
Volumes in 
VOLT 


2 

Relative Pointer to 
Volume Table Entry 


52 (34) 


1 

Internal 
DD Number 


Number of 
Units for 
This Data Set 


1 
Volume 
Count 


1 
Disposition 


4 
Indicator Bytes 


60 (3C) 


8 
Unit Type 


68 (44) 


8 
System Output Program Name 


76 (AC) 


4 
System Output Form Number 


System 
Output 
Class 


1 

DD Statement 

Duplicate 
Number 


2 

Reserved 


84 (54) 


4 
Queue Address of DSB for this Data Set 


4 
Queue Address of Next DSB 


92 (5C) 


1 
Conditional 
Disposition 


3 
TTRofSIOT 
being passed 


26 




Res 


erved 








& NAME from DSNAME ~ 
for Dedicated Work Files 


124 (7C) 
132 (84) 


8 
5c NAME from DSNAME = for Dedicated Work Files 
(Continued) 


44 


■» 


DCB Reference Name 























•Figure 42. Step Input/Output Table (SIOT) 
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0(0) 



1(8) 



16 (10) 



24(18) 



32 (20) 



40 (28) 



Job Name 



Step Name 



Name of Step Calling Procedure, or Zeros 



Entry 
Length 



Status 
Bits 



Allocation 
Data 



DD Name (continued) 



Status 
Bits 



Address of UCB 
or Link Value 



DD Name 



Address in Queue of 
JFCB or SIOT 



Status 
Bits 



Status 
Bits 



First 

DD 

Entry 



Address of UCB 
or Link Value 



~~1 

Device 
Entries 

jL 



_i 

Last 
DD 
Entry 



Zeros - End of TIOT 



Figure 43. Task Input/ Output Table (TIOT) 
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Appendix B: MFT Modules 



This appendix contains a table of unique MFT modules, a group of tables showing the 
modules of each major component , a list matching entry point and control section names 
with source module names, and a brief description of each of the modules used by MFT, If 
you are looking for a specific module and know only the major component and routine name, 
use Tables 3-14 which give a cross-reference to the source module. The source modules 
are in turn listed alphanumerically for easy access. If you know the source module name, 
go directly to the module descriptions. 

Unique MFT Modules 

Table 2 lists all modules that are unique to MFT. This table is organized alphabetically 
by major component. 



Table 2. MFT Modules 

r 



ABEND : 

IEAGTM05 
IEAGTM06 
IEAGTM08 
IEAGTM09 

Communications Task ; 

IEECIR45 
IEEVWTOR 

Initiator : 

IEFSD510 
IEFSD511 
IEFSD512 
IEFSD513 
IEFSD515 
IEFSD516 
IEFSD517 
IEFSD518 
IEFSD519 
IEFSD540 
IEFSD541 
IEFSD553 
IEFSD554 
IEFSD555 
IEFSD556 
IEFSD558 
IEFSD559 
IEFSD589 
IEFSD598 
IEFSD599 



I/O Device Allocation : 

IEFSD551 
IEFSD552 
IEFSD557 



Master Scheduler Task : 

IEECIR50 
IEEDFIN1 
IEEDFIN2 
IEEDFIN3 
IEEDFIN4 
IEEDFIN5 
IEEDFIN6 
IEEDFIN7 
IEEDFIN8 
IEEDFIN9 
IEESD561 
IEESD562 
IEESD563 
IEESD564 
IEESD565 
IEESD566 
IEESD571 
IEFSD569 

Nucleus: 

IEESD568 
IEFSD567 



Queue .Management : 

IEFSD514 
IEFSD572 



Reader /Interpreter : 

IEFSD530 
IEFSD531 
IEFSD532 
IEFSD533 
IEFSD536 
IEFSD537 

System Task Control : 

IEESD590 
IEESD591 
IEESD592 
IEFSD534 
IEFSD535 
IEFSD587 
IEFSD588 



100 



Major Component Modules 



Tables 3 through 14 list all MFT modules according to major component. The tables appear 
in alphabetical order by component name. Within each component, routine names are listed 
alphabetically with a cross-reference to the module name. 
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Table 3, 



AEEND Modules 



Table 6* I/O Device Allocation Modules 



r . 


— i 


1 

Source | 


| Routine 


— — , -L 


Module | 


IP-.-.. «.- 


T 1 


| ABDUMP 




IEAATM04 | 


| Indicative Dump 




IEAATM03 | 


| Initialization 




IEAGTMOO | 


| input/Output Purge 




IEAGTM06 | 


Linkage 




IEAATM01 | 


| Main Storage Allocation 




IEAATM02 | 


| Termination 




IEAGTM05 | 


| DAR Core Image Dump 




IEAGTM08 | 


| DAR Task Reinstatement 


| IEAGTM09 | 



Table 4. communication Task Modules 



Console Device Processor 

Console Interrupt 

External Interrupt 

Initialization Routine 

Purge RQE 

Router 

Wait 

Write- to- Operator 

Write- to- Operator-With-Reply 

EXCP OPEN/CLOSE 

MCS Comm Task Router 

MCS Console switch 

MCS Device Interface 

MCS 1052 Device Support 

MCS 1403/1443 Device Support 

MCS 2540 Device Support 

MCS 2740 Device Support 

MCS Delete Operator Message 

MCS WTO/WTCR Processor (SVC 

35) 
WTCR Purge (End of Job) 



IEECVPM 

IEECVCRA 

IEECVCRX 

IEECVCTI 

IEECVED2 

IEECVCTR 

IEECVCTW 

IEECVWTO 

IEEVWTOR 

IEECVOC 

IEECMAWR 

IEECMCSW 

IEECMDSV 

IEECMPMX 

IEECMPMP 

IEECMPMC 

IEEC2740 

IEECMDOM 

IEECMWSV 
IEAGTM07 



Table 



Initiator Modules 



Alternate Step Deletion 
Data Set Integrity 
Dequeue by Jobname Interface 
ENQ/DEQ Purge 
Job Deletion 
Job Initiation 
Job Selection 
Job Suspension 
Linkage to IEFSD510 
Linkage to IEPSD511 
Linkage to IEFSD512 
Linkage to IEFSD515 
Linkage to IEFSD516 
Linkage to IEFSD534 
Linkage to IEFSD541 
Partition Recovery 
Problem Program Interface 
Set Problem Program State 
Small Partition Module 
Step Deletion 
Step Initiation 



^ 1 

IEFSD516 
IEFSD541 
IEFSD519 
IEFSD598 
IEFSD517 
IEFSD511 
IEFSD510 
IEFSD168 
IEFSD555 
IEFSD558 
IEFSD553 
IEFSD559 
IEFSD554 
IEFSD589 
IEFSD540 
IEFSD518 
IEFSD513 
IEFSD556 
IEFSD599 
IEFSD515 
IEFSD512 



Routine 



Allocation Control 
Allocation Entry 
Allocation Exit 
Allocation Recovery Messages 
Allocation Recovery 
Automatic Volume Recognition 
Automatic Volume Recognition 

Messages 
Automatic Volume Recognition 

Non-standard Label Routine 
DADSM Error Recovery 
Decision Allocation 
Demand Allocation 
Device strikeout 
EXEC Statement Condition 

Code Processor 
EXEC Statement Condition 

Code Processor Messages 
External Action Messages 
External Action 
interface 
JFCB Housekeeping Control 

and Allocate Processing 
JFCB Housekeeping Error Mes- 
sage Processing 
JFCB Housekeeping Error 

Messages 
JFCB Housekeeping Fetch DCB 

Processing 
JFCB Housekeeping GDG All 

Processing 
JFCB Housekeeping GDG Single 

Processing 
JFCB Housekeeping Patterning 

DSCB 
JFCB Housekeeping Unique 

Volume ID 
Mount Control -Volume Routine 
Linkage Module 
Linkage Module 
Linkage Module 
Linkage Module 

Linkage to JFCB Housekeeping 
Linkage to JFCB Housekeeping 
Linkage to IEFXJIMP 
Linkage to IEFXJIMP 
Linkage to IEFXV001 
Linkage to Mount control 

Volume 
Message Module 
Message Module 
Non-Recovery Error 
Non-Recovery Error Messages 
Separation Strikeout 
Space Request 
VARY Interface and TICT 

compression 
TIOT construction 
Unsolicited Device Interrupt 

Handler 
Wait for Space Decision 
Wait for Unallocation 



Source 
Module 



IEFXCSSS 
IEFSD21Q 
IEFSD41Q 
IEFSJMSG 
IEFXJIMP 
IEFXV001 

IEFVMSG 

IEFXVNSL 
IEFXT003 
IEFS5000 
IEFWA000 
IEFX300A 

1EFVKIMP 

IEFVKMSG 
IEFWD001 
IEFWD000 
IEFSD557 

IEFVMLS1 

IEFVKLS6 

IEFVMLS7 

IEFVM2LS 

IEFVM4LS 

IEFVM3LS 

IEFVM5LS 

IEFVM76 

IEFMCVCL 

IEFWCFAK 

IEFWDFA 

IEFWSWIN 

IEFXJFAK 

IEFVMMS1 

IEFVMFAK 

IEFSD551 

IEFSD552 

IEFAVFAK 

IEFCVFAK 
IEFWSTRT 
IEFXAMSG 
IEFXKIMP 
IEFXKMSG 
IEFXH000 
IEFXT00D 

IEFXT002 
IEFWCIMP 

IEFVPOST 
IEFSD097 
IEFSD195 
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Table 7. Interpreter Modules 



Table 8. Master Scheduler Modules 



f 


~ - — 1 


— 1 

Source | 


| Routine 




Module | 


u - 


„ , 


, j 


r 




— .j 


| Command 


Statement 


IEFVHM j 


j CPO Allocation Subroutine 


IEFVSD12 | 


i CPC 




IEFVHG | 


j Continuation Statement 


IEFVBC | 


j DD* Statement Generator 


IEFVHB | 


| DD Statement Processor 


IEEFVDA | 


j Data Set Name Table 




j Construction 


IEFVDBSD | 


| Dictionary Entry 


IEFVGI | 


j Dictionary Search 


IEFVGS j 


| End~of-File 


IEFVHAA | 


| EXEC Statement Processor 


IEFVEA | 


j Get Parameter 


IEFVGK | 


j Get 




IEFVEA j 


j Housekeeping 


IEFVHHB | 


j Initialization 


IEFVH1 | 


j Initialization 


IEFVH2 | 


[ Interface 


IEFSD533 j 


j Job and 


Step Enqueue 


IEFVHH | 


j Job Statement Processor 


IEFVHA | 


j Job Validity Check 


IEFVHEC j 


j Linkage 


Module 


IEFSD537 | 


j Message 


Module 


IEFVGM1 | 


j Message 


Module 


IEFVGM2 | 


j Message 


Module 


IEFVGM3 j 


j Message 


Module 


IEFVGM4 | 


| Message 


Module 


IEFVGM5 | 


j Message 


Module 


IEFVGM6 | 


j Message 


Module 


IEFVGM7 j 


| Message 


Module 


IEFVGM8 | 


j Message 


Module 


IEFVGM9 | 


| Message 


Module 


IEFVGM10 | 


j Message 


Module 


IEFVGM11 j 


j Message 


Module 


IEFVGM12 j 


| Message 


Module 


IEFVGM13 | 


j Message 


Module 


IEFVGM14 j 


j Message 


Module 


IEFVGM15 | 


j Message 


Module 


IEFVGM16 | 


j Message 


Module 


IEFVGM17 | 


j Message 


Module 


IEFVGM18 | 


| Message 


Module 


IEFVGM70 j 


j Message 


Module 


IEFVGM78 | 


j Message 


Processing 


IEFVGM | 


| Null Statement 


IEFVHL | 


j Operator Message 


IEFSD536 | 


j Post-Scan 


IEFVBF | 


j Pre-scan Preparation 


IEFVHEB | 


j Queue Management Interface 


IEFVHQ | 


| Router 




IEFVHE j 


| Scan 




IEFVFA | 


j SCD Construction 


IEFVSD13 | 


| Symbolic Parameter 




j Processing 


IEFVFB | 


| Termination 


IEFVHN | 


j Test and Store 


IEFVGT | 


| Transient Reader Restore 


IEFSD531 | 


j Transient Reader Suspend 


IEFSD530 | 


j Transient Reader Suspend 




j Tests 




IEFSD532 | 


j Vary Identification 


IEFVHCB | 



Routine 



DEFINE Command Final 

Processor 
DEFINE Final Processor 
DEFINE Initialization 
DEFINE Keyword Scan 
DEFINE Listing 
DEFINE Message 
DEFINE Syntax Check and 

Router 
DEFINE System 

Reinitial ization 
DEFINE Time- Si ice Syntax 

Check 
DISPLAY A 
Look-up Routine 
Queue Search 
Queue Search Setup 
Service 
Syntax Check 
Time- Slice Syntax Check 
Wait/Router 
Resident Volume 

Initialization 
Message Module 
System Log Initialization 
System Log Open Initializer 
System Log Output Writer 
System Log Dispatcher 
System Log Wait Routine 
System Log SVC (SVC 36) 
System Log SVC (SVC 36 - 

second load) 
DISPLAY CONSOLES 
Master Scheduler Resident 

Data Area 
Master Scheduler 

Initialization 
User Dummy WTO/WTOR Exit 
Console Initialization 



T — ., 

Source 
Module 
^ 



IEEDFIN9 
IEEDFIN3 
IEEDFIN1 
IEEDFIN7 
IEEDFIN4 
IEEDFIN5 

IEEDFIN2 

IEEDFIN8 

IEEDFIN6 
IEESD566 
IEEVRFRX 
IEESD564 
IEESD563 
IEESD565 
IEESD562 
IEEDFIN6 
IEECIR50 

IEFPRES 

IEFK1MSG 

IEEVLIN 

IEEVLIN2 

IEEVLOUT 

IEEVLDSP 

IEEIWAIT 

IEE0303F 

IEE0403F 
IEEXEDNA 

IEESD568 

IEESD569 
IEECVCTE 
IEECVCTI 
J 



Table 9, Queue Management Modules 



L J J 



Assign 

Assign/Start 

Branch 

Control 

Delete 

Dequeue 

Dequeue by Jobname 

Dummy 

Enqueue 

interpreter /Queue Manager 

Interlock 
Message Module 
Queue Formatting 
Queue Initialization 
Queue Manager Table Breakup 
Read/Write 
Resident Main Storage 

Reservation 
Unchain 



- T ^ 

IEFQASGQ 
IEFQAGST 
IEFQMLK1 
IEFQBVMS 
IEFQDELQ 
IEFQMDQQ 
IEFLCCDQ 
IEFQMDUM 
IEFQMNQQ 

IEFSD572 
IEFSD311 
IEFORMAT 
IEFSD055 
IEFSD514 
IEFQMRAW 

IEFPRESD 
IEFQMUNQ 

.J , — ,., 
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Table 10. SVC 34 Modules 



Table 12. 

r 



System Restart Modules 

T — 





Source 


j Routine 

i 


Module 


1 





| CSCB Creation 


IEE0803D 


| CSCB Marking 


IEE0703D 


| DEFINE, MOUNT, CANCEL 


IEESD571 


| HALT 


IEE1403D 


j Message Assembly 


IEE0503D 


j Message Assembly 


IEE2103D 


j Reply Processor 


IEE1203D 


j Router 


IEE0403D 


| SET Command Handler 


IEE0903D 


| SET Command 


IEE0603D 


j START and STOP INIT 


IEESD561 


| Translator/Chain Manipulator 


IEE0303D 


j VARY and UNLOAD 


IEE1103D 


j MCS Reply Processor 


IEE1A03D 


j MCS Reply Messages 


IEE1B03D 


j RJE Commands 


IEE1503D 


| LOG and WRITELOG Routine 


IEE1603D 


| VARY ONGFX/OFFGFX Handler 


IEE1703D 


j System Management Facilities 


IEE2303D 


| MODE Command Handler 


IEE2603D 


| DISPLAY R Handler 


IEE2903D 


| VARY and UNLOAD Processor II 


IEE3103t> 


j HARDCPY Message routine 


IEE4103D 


j VARY Scan and Router 


IEE4203D 


| VARY MSTCONS Handler 


IEE4303D 


| VARY Keyword Scan 


IEE4403D 


j STOP Command Handler 


IEE4503D 


j VARY CN/CFFLINE of Consoles 




j and Message Handler 


IEE4603D 


| VARY HARDCPY Handler 


IEE4703D 


| VARY CONSOLE Message routine 


IEE4803D 


j VARY CONSOLE Handler 


IEE4903D 



L ± J 



Table 11. System Output Writer Modules 



Class Name Setup 

Command Processing 

Data Set Delete 

Data Set Writer Interface 

DSB Handler 

Initialization 

Job Separator 

Linkage Module 

Linkage Module 

Linkage Module 

Linkage Module 

Linker 

Linkage to Queue Manager 

Delete 
Main Logic 
Message Module 
Print Line 
Put 

SMB Handler 
Standard Writer 
Transition 
Wait 



t 1 

IEFSD081 
IEFSD083 
IEFSD171 
IEFSD070 
IEFSD085 
IEFSD080 
IEFSD094 
IEF078SD 
IEF079SD 
IEF082SD 
IEF083SD 
IEFSD078 

IEFSD079 
IEFSD082 
IEFSD096 
IEFSD095 
IEFSD089 
IEFSD086 
IEFSD087 
IEFSD088 
IEFSD084 



Routine 



Delete 

Initialization 
Jobnames Table 
Linkage Module 
Linkage Module 
Message Module 
Purge Queue Construction 
Scratch Data Sets 
Scratch Data Sets 
TTR and NN to MBBCCHHR 
Conversion 



Source 
Module 



IEFSD303 
IEFSD300 
IEFSD302 
IEF300SD 
IEF304SD 
IEFSD312 
IEFSD301 
IEFSD304 
IEFSD308 

IEFSD310 



Table 
r" 



13. System Task Control Modules 



Allocation Interface 

Internal JCL Reader 

Interpreter Control 

JCL Edit 

Linkage to IEFSD535 

Linkage to IEE534SD 

Linker 

Link- Table 

LPSW 

Message Writer 

Message Writer 

Message Writing 

POST 

Problem Program Mode 

QMPA Builder 

START Syntax Check 

Termination Interface 

Write TIOT on Disk 



IEEVACTL 

IEEVICLR 

IEEVRCTL 

IEEVJCL 

IEFSD587 

IEFSD588 

IEESD591 

IEEV1NKT 

IEFSD534 

IEEVMSG1 

IEEVSMSG 

IEEVOMSG 

IEESD592 

IEFSD535 

IEEVSMRA 

IEEVSTAR 

IEEVTCTL 

IEESD590 
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Table 14 . Termination Modules 





Source 


j Routine 

L J 


Module 


r 1 

| Disposition and Unallocation ! 





j Messages j 


IEFZGMSG 


| VARY Interface and Disposi- 




j tion and Unallocation 




j Messages 


IEFZHMSG 


| Disposition and Unallocation 


IEFZGJB1 


j Disposition and Unallocation 


IEFZGST1 


j DSB Processing 


IEFYTVMS 


| Job Statement Condition Code 




| Processor 


IEFVJIMP 






| Processor Messages 


IEFVJMSG 


j Job Termination Control 


IEFZAJB3 


| Job Termination Exit 


IEFSD31Q 


j Message Blocking 


IEFYSVMS 


j Message Module 


IEFWTERM 


j Message 


IEFIDMPM 


j Restart Preparation 


i IEFRPREP 


| Step Termination Control 


IEFYNIMP 


j Step Termination Control 




j Routine Messages 


IEFYNMSG 


| Step Termination Data Set 




j Driver 


| IEFYPJB3 


| Step Terminate Exit 


| IEFSD22Q 


j Step Termination Messages 


j IEFYPMSG 


j System Output Interface 


| IEFSD017 


j Termination Entry 


IEFSD42Q 


| User Accounting Routine 




j Linkage 


| IEFACTLK 


j User Dummy Accounting 


| IEFACTFK 
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Module Descriptions 



This section contains a brief description of each of the modules used by MFT. An alpham- 
eric list of the entry point and control section names, together with the name of the 
module that contains them, is provided to allow cross-referencing between modules. 
Modules are listed alphamerically by module name; associated with each module is a 
descriptive name, which indicates the major component of the system to which the module 
belongs. Each module contains a brief statement of the purpose of the module. Where ap- 
plicable, the description includes the names of the module's entry points, the names of 
the modules to which it passes control, the major tables and work areas to which it 
refers, its attributes, the names of the control sections it contains, and a page 
reference to the detailed writeup in the Job Management section. 



r n 

| Entry Point or | 


Module Name 


j Control Section 




i Name j 

L . 1 




r 1 




I G0 i 


IEFSD515 


| IEAGENQl 


IEAGENQl 


IEAGENQ2 


IEAGENQ2 


IEAQCTOO | 


IEE0903D 


j IEA0TI01 i 


IEA0TI01 


IEEBA1 i 


IEECVCRA 


IEEBC1PE | 


IEECVCRX 


| IEECIR45 j 


IEECVCTW 


| IEECIR50 | 


IEECIR50 


| IEECMDOM j 


IEECMDOM 


IEECMDSV i 


IEECMDSV 


IEECMWRT | 


IEECMAWR 


IEECMWSV 


IEECMWSV 


IEECMWTL | 


IEECMWTL 


| IEECVCTI 


IEECVCTI 


| IEECVCTR | 


IEECVCTR 


| IEECVCTW 


IEECMAWR 


| IEECVPM i 


IEECVPM 


j IEECVPRG 


IEECVED2 


| IEECVXIT 


IEECVCTE 


| IEEDFINl 


IEEFIN1 


| IEEDFIN2 


IEEDFIN2 


| IEEDFIN3 


IEEDFIN3 


| IEEDFIN4 


IEEDFIN4 


| IEEDFIN5 


IEEDFIN5 


j IEEDFIN6 


IEEDFIN6 


| IEEDFIN7 


IEEDFIN7 


| IEEDFIN8 


IEEDFIN8 


| IEEDFIN9 


IEEDFIN9 


| IEEDPART 


IEEDFIN2 


| IEELCG02 


IEELOG02 


| IEELWAIT 


IEELWAIT 


| IEEMSER 


IEESD568 


| IEEPDISC 


IEEPDISC 


| 1EESD562 


IEESD562 


| IEESD563 


IEESD563 


| IEESD564 


IEESD564 


| IEESD565 


IEESD565 


| IEESD566 


i IEESD566 


| IEESD567 


IEESD567 


| IEESD590 


| IEESD590 


| IEESD591 


i IEESD591 



Entry Point or 

Control Section 

Name 



IEESD592 

IEEVACTL 

IEEVICLR 

IEEVJCL 

IEEVLIN 

IEEVLDSP 

IEEVLNKT 

IEEVLOUT 
IEEVMSG1 
IEEVOMSG 
IEEVRCTL 
IEEVRFRX 
IEEVSMBA 
IEEVSMSG 

IEEVSTRT 
IEEVTCTL 
IEEXEDNA 
IEE0303D 
IEE0303F 
IEE0403D 
IEE0403F 

IEE0503D 
IEE0603D 
IEE0703D 
IEE0803D 
IEE1103D 
IEE1203D 
IEE1403D 

IEE1603D 
IEE1703D 
IEE1A03D 
IEE1B03D 
IEE2103D 
IEE2303D 
IEE2603D 

IEE2903D 
IEE3103D 
IEE4103D 
IEE4203D 
IEE4303D 
IEE4U03D 
IEE4503D 



Module Name 



IEESD592 

IEEVACTL 

IEEVICLR 

IEEVJCL 

IEEVLIN 

IEEVLDSP 

IEEVLNKT 

IEEVLOUT 
IEEVMSG1 
IEEVOMSG 
IEEVRCTL 
IEEVRFRX 
IEEVSMBA 
IEEVSMSG 

IEEVSTAR 
IEEVTCTL 
IEEXEDNA 
IEE0303D 
IEE0303F 
IEE0403D 
IEE0403F 

IEE0503D 
IEE0603D 
IEE0703D 
IEE0803D 
IEE1103D 
IEE1203D 
IEE1403D 

IEE1603D 
IEE1703D 
IEE1A03D 
IEE1B03D 
IEE2103D 
IEE2303D 
IEE2603D 

IEE2903D 
IEE3103D 
IEE4103D 
IEE4203D 
IEE4303D 
IEE44 03D 
IEE4503D 



— 1 
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r 1 

| Entry Point or 




j Control Section 


Module Name 


j Name 

L : „ 




r 


t „ L ^ _, _ k— 


| IEE4603D 


IEE4603D 


| IEE4703D 


IEE4703D 


| IEE4803D 


IEE4803D 


| IEE4903D 


IEE4903D 


| IEE591SD 


IEESD591 


| IEFACTLK 


IEFACTFK 


j IEFACTLK 


IEFACTLK 


| IEFACTRT 


IEFACTRT 


| IEFCVCL1 


IEFCVFAK 


| IEFCVCL1 


IEFMCVOL 


| IEFCVCL2 


IEFCVFAK 


| IEFCVCL2 


IEFMCVOL 


| IEFCVCL3 


IEFCVFAK 


| IEFCVCI3 


IEFMCVOL 


| IEFDPCST 


IEFVPOST 


| IEFDSDRP 


IEFDSDRP 


| IEFICR 


IEEVICIR 


| IEFIDMPM 


IEFIDMPM 


| IEFIRC 


IEFSD533 


| IEFJCB 


IEFQRESD 


| IEFKG 


IEFSD532 


j IEF0RMAT 


IEFORMAT 


j IEFPH2 


IEFSD531 


j IEFQAGST 


IEFQAGST 


| IEFQASGN 


IEFQASGQ 


| IEFQASNM 


IEFQASGQ 


j IEFQDELE 


IEFQDELQ 


| IEFQMDQ2 


IEFQMDQQ 


j IEFQMDUM 


IEFQMDUM 


| IEFQMNQ2 


IEFQMNQQ 


| IEFQMSSS 


IEFQBVMS 


| IEFQMSSS 


IEFQMDUM 


| IEFQMSSS 


IEFQMLK1 


| IEFQMRAW 


IEFQMRAW 


| IEFQMUNC 


IEFQMUNQ 


| IEFRCLN1 


IEFRCLN1 


| IEFRCLN2 


IEFRCLN2 


j IEFRPREP 


IEFRPREP 


| IEFRSTRT 


IEFRSTRT 


| IEFSD012 


IEFVSD12 


| IEFSD017 


IEFSD017 


j IEFSD055 


IEFSD055 


| IEFSD068 


IEFSD168 


| IEFSD070 


IEFSD070 


| IEFSD071 


IEFSD171 


| IEFSD078 


IEFSD078 


| IEFSD078 


IEF078SD 


j IEFSD079 


IEFSD079 


| IEFSD079 


IEF079SD 


| IEFSD080 


IEFSD080 


| IEFSD081 


IEFSD081 


j IEFSD082 


IEF082SD 



r T 


| Entry Point or 




j Control Section 


Module Name 


| Name 

L , , , 




|. 


._«,.._ M — 


| IEFSD082 


IEFSD082 


| IEFSD083 


IEFSD083 


j IEFSD083 


IEF083SD 


| IEFSD084 


IEFSD084 


| IEFSD085 


IEFSD085 


| IEFSD086 


IEFSD086 


| IEFSD087 


IEFSD087 


| IEFSD088 


IEFSD088 


| IEFSD089 


IEFSD08 9 


| IEFSD090 


IEFVSD13 


| IEFSD094 


IEFSD094 


| IEFSD095 


IEFSD095 


| IEFSD095 


IEFSD195 


j IEFSD096 


IEFSD096 


| IEFSD097 


IEFSD097 


| IEFSD300 


IEF300SD 


j IEFSD300 


IEFSD300 


| IEFSD301 


IEFSD301 


| IEFSD302 


IEFSD302 


| IEFSD303 


IEFSD303 


| IEFSD304 


IEFSD304 


| IEFSD304 


IEF304SD 


| IEFSD305 


IEFSD305 


| IEFSD308 


IEFSD308 


| IEFSD310 


IEFSD310 


| IEFSD311 


IEFSD311 


| IEFSD312 


IEFSD312 


| IEFSD510 


IEFSD510 


| IEFSD511 


IEFSD511 


j IEFSD512 


IEFSD512 


| IEFSD512 


IEFSD553 


| IEFSD513 


IEFSD513 


| IEFSD514 


IEFSD514 


| IEFSD515 


IEFSD515 


| IEFSD516 


IEFSD516 


| IEFSD517 


IEFSD517 


| IEFSD518 


IEFSD518 


| IEFSD519 


IEFSD519 


| IEFSD530 


IEFSD530 


j IEFSD531 


IEFSD531 


| IEFSD534 


IEFSD534 


| IEFSD535 


IEFSD535 


j IEFSD537 


IEFSD537 


| l!EFSD540 


IEFSD54 


| IEFSD541 


IEFSD541 


| IEFSD554 


IEFSD55U 


j IEFSD555 


IEFSD555 


| IEFSD556 


IEFSD556 


j IEFSD557 


IEFSD557 


j IEFSD558 


IEFSD558 


| IEFSD559 


IEFSD559 


j IEFSD567 


IEFSD567 



L„ . _ .^X. , _ J I , X . . . J 
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r t 


| Entry Point or 




| Control Section 


Module Name 


j Name 




L 




1 





| IEFSD569 


IEFSD569 


| IEFSD572 


IEFSD572 


j IEFSD573 


IEFSD572 


| IEFSD587 


IEFSD587 


j IEFSD588 


IEFSD588 


| IEFSD589 


IEFSD589 


| IEFSD597 


IEFSD597 


| IEFSD598 


IEFSD598 


j IEFSD599 


IEFSD599 


| IEFSD71M 


IEFSD171 


| IEFSD83M 


IEFSD083 


| IEFSD85M 


IEFSD085 


| IEFSD86M 


IEFSD086 


j IEFSD877 


IEFSD087 


| IEFSD897 


IEFSD089 


| IEFSMR 


IEFRSTRT 


| IEFUCBL 


IEFWA000 


| IEFVAWAT 


IEFSD195 


| IEFVDA 


IEFVDA 


| IEFVDBSD 


IEFVDBSD 


| IEFVEA 


IEFVEA 


| IEFVFA 


IEFVFA 


j IEFVFB 


IEFVFB 


j IEFVGI 


IEFVGI 


| IEFVGK 


IEFVGK 


| IEFVGM 


IEFVGM 


| IEFVGiy51 


IEFVGM1 


j IEFVGM2 


IEFVGM2 


| IEFVGM3 


IEFVGM3 


| IEFVGM4 


IEFVGM 4 


| IEFVGM5 


IEFVGM5 


| IEFVGM6 


IEFVGM 6 


| IEFVGM7 


IEFVGM7 


| IEFVGM8 


IEFVGM8 


| IEFVGM9 


IEFVGM9 


| IEFVGiyilO 


IEFVGM10 


| IEFVGM11 


IEFVGM11 


j IEFVGJyil2 


IEFVGM12 


| IEFVGM13 


IEFVGM13 


| IEFVGM14 


IEFVGM14 


| IEFVGM15 


IEFVGM15 


| IEFVGM16 


IEFVGM16 


j IEFVGM17 


IEFVGM 1M 


| IEFVGM18 


IEFVGM18 


| IEFVGM19 


IEFVGM19 


| IEFVGM70 


IEFVGM70 


| IEFVGM78 


IEFVGM78 


| IEFVGS 


IEFVGS 


| IEFVGT 


IEFVGT 


| IEFVHA 


IEFVHA 


| IEFVHAA 


IEFVHAA 


| IEFVHB 


IEFVHB 



H h 



L X. J 



Entry Point or 




Control Section 


Module Name 


Name 






— 









IEFVHC 


IEFVHC 


IEFVHCB 


IEFVHCB 


IEFVHE 


IEFVHE 


IEFVHEB 


IEFVHEB 


IEFVHEC 


IEFVHEC 


IEFVHF 


IEFVHF 


IEFVHG 


IEFVHG 


IEFVHH 


IEFVHH 


IEFVHHB 


IEFVHHB 


IEFVHL 


IEFVHL 


IEFVHM 


IEFVHM 


IEFVHN 


IEFVHN 


IEFVHQ 


IEFVHQ 


IEFVHR 


IEFSD536 


IEFVH1 


IEFVH1 


IEFVH2 


IEFVH2 


IEFVJ 


IEFVJIMP 


IEFVJA 


IEFVJA 


IEFVJMSG 


IEFVJMSG 


IEFVK 


IEFVKIMP 


IEFVKMJ1 


IEFVKMSG 


IEFVKMSG 


IEFVKMSG 


IEFVM 


IEFVMLS1 


IEFVMCVL 


IEFVMFAK 


IEFVMCVL 


IEFVMLS1 


IEFVMQMI 


IEFVMLS1 


IEFVMSGR 


IEFVMLS6 


IEFVM1 


IEFVMLS1 


IEFVM1 


IEFVMMS1 


IEFVM 2 


IEFVM2LS 


IEFVM3 


IEFVM3LS 


IEFVM 4 


IEFVM4LS 


IEFVM 5 


IEFVM5LS 


IEFVM 6 


IEFVMLS6 


IEFVM7 


IEFVMLS7 


IEFVM76 


IEFVM76 


IEFVRRC 


IEFVRRC 


IEFVRRCA 


IEFVRRC 


IEFVRRCB 


IEFVRRC 


IEFVRR1 


IEFVRR1 


IEFVRR2 


IEFVRR2 


IEF VRR 3 


IEFVRR3 


IEFVSDRA 


IEFVSDRA 


IEFVSDRD 


IEFVSDRD 


IEFVSMBR 


IEFVSMBR 


IEFV15XL 


IEFXJIMP 


IEFV15XL 


IEFSD551 


IEFVR2AE 


IEFVRR2 


IEFVR3AE 


IEFVRR3 


IEFWA000 


IEFWA000 


IEFWA002 


IEFWA000 


IEFWA7 


IEFWA000 



L , JL J 
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r t 


| Entry Point or 




1 Control Section 


Module Name 


j Name 

i 




1 ; 


„ 


| IEFWCO00 


IEFWCFAK 


| IEFWCOOO 


IEFWCIMP 


| IEFWC002 


IEFWCIMP 


| IEFWDOOO 


IEFWDFAK 


| IEFWDOOO 


IEFWDOOO 


| IEFWD001 


IEFWDOOl 


| IEFWDMSG 


IEFWDOOO 


| IEFWLISD 


IEFSD21Q 


| IEFWSTKT 


IEFWSTRT 


| IEFWSWIT 


IEFWSWIN 


| IEFWTERM 


IEFWTERM 


| IEFW1FAK 


IEFSD41Q 


j IEFW1FAK 


IEF41FAK 


| IEFW2FAK 


IEFSD41Q 


| IEFW2FAK 


IEF41FAK 


| IEFW21SD 


IEFSD21Q 


| IEFW21SD 


IEFSD557 


j IEFW22SD 


IEFSD22Q 


| IEFW31SD 


IEFSD31Q 


| IEFW41SD 


IEFSD41Q 


| IEFW41SD 


IEF41FAK 


j IEFW42SD 


IEFSDU2Q 


| IEFXA 


IEFXCSSS 


j IEFXAMSG 


IEFXAMSG 


| IEFXHO00 


IEFXHOOO 


| IEFXJMSG 


IEFXJMSG 


j IEFXJX5A 


IEFSD552 


| IEFXJX5A 


IEFXJIMP 


j IEFXJ000 


IEFXJFAK 


| IEFXJOOO 


IEFXJIMP 


| IEFXKMSG 


IEFXKMSG 


| IEFXKO00 


IEFXKIMP 


| IEFXTO00 


IEFXTOOD 


| IEFXT002 


IEFXT002 


| IEFXT003 


IEFXT003 


| IEFXVMSG 


IEFXVMSG 


| IEFXVNSL 


IEFXVNSL 


| IEFXVOOl 


IEFAVFAK 


| IEFXVOOl 


IEFXVOOl 


j IEFXV002 


IEFXV002 


| IEFX3000 


IEFX300A 


| IEFX5000 


IEFX5000 


j IEFYN 


IEFYN IMP 


| IEFYNMSG 


IEFYNMSG 


j IEFYP 


IEFYP JB 3 


| IEFYPMSG 


IEFYPMSG 


| IEFYS 


IEFYSVMS 


| IEFYT 


IEFYTVMS 


| IEFZA 


IEFZAJB3 


| IEFZG 


IEFZGST1 


| IEFZGJ 


IEFZGJB1 


| IEFZGMSG 


IEFZGMSG 



H h 



L X J 



Entry Point or 

Control Section 

Name 



IEFZH 

IEF085SD 

IEF086SD 

IEF850SD 

IEG056 

IEG056 

IGCXL07B 

IGCXM07B 

IGCXN07B 

IGCX007B 

IGC0001C 
IGC0003E 
IGC0005B 
IGC00060 
IGC0101C 

IGC0103D 
IGC0103E 
IGC0111C 
IGC0201C 
IGC0211C 

IGC0221C 

IGC0301C 

IGC0401C 

IGC048 

IGC048 

IGC0501C 
IGC0601C 
IGC0701C 
IGC0801C 
IGC0901C 

IGC0907B 
IGC0B01C 
IGC0C01C 
IGC0D01C 
IGC0E01C 

IGC1803D 
IGC1903D 
IGF2603D 
IGF2703D 
LOC 

LOCCAN 
LOCDQ 
MSOFF 
MSRCV 

MSSYS 

SD304MG1 
SD304MG2 
SD305MG1 
SD55MSG1 
SD55MSG2 

SD55MSG3 
SMALLGO 



Module Name 



IEFZHMSG 
IEFSD085 
IEFSD086 
IEFSD085 
IEAGENQ1 

IEAGENQ2 
IEECMCSW 
IEECMCSW 
IEECMCSW 
IEECMCSW 

IEAGTMOA 
IEECVWTC 
IEFVSMBR 
IEAASTOO 
IEAATMOl 

IGC0103D 
IEEVWTOB 
IEAATMOA 
IEAATM02 
IEAATM2A 

IEAATM2E 
IEAATM03 
IEAATM04 
IEAGENQ1 
IEAGENQ2 

IEAGTM05 
IEAGTM06 
IEAGTMOO 
IEAGTM08 
IEAGTM09 

IEECMWTI 
IEAATMOE 
IEAATMOC 
IEAATMOD 
IEAATMOE 

IEESD571 
IEESD561 
IGF2603D 
IGF2703D 
IEFLOCDQ 

IEFLOCDQ 
IEFLOCDQ 
IEFXJMSG 
IEFXJMSG 
IEFXJMSG 

IEFSD312 
IEFSD312 
IEFSD312 
IEFSD311 
IEFSD311 

IEFSD311 
IEFSD599 
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r _ . T , 


| Entry Point or 




| Control Section 


Module Name 


j Name 




L 




Y 





| SiytALTERM 


IEFSD515 


j SMAITERM 


IEFSD559 


| STRKSG01 


IEFYNMSG 


| VM7000 


IEFVMLS1 


| VM7055 


IEFVjyiLSl 


| VM7055AA 


IEFVMLSl 


| VM7060 


IEFVMLS1 


| VM7065 


IEFVMLS1 


j VM7070 


IEFVMLS1 


j VJyi7090 


IEFVMLS1 


| VM7100 


IEFVM2LS 


j VM7130 


IEFVMLS1 


j VM7150 


IEFVM3LS 


| VM7200 


IEFVM4LS 


j VM7300 


IEFVM5LS 


| VM7370 


IEFVMLS1 


| VM7600 


IEFVM76 


| VM77Q0 


IEFYMLS1 


| VM7742 


IEFJMLS1 


| VM7750 


IEFVMLS1 


| VM7850 


j IEFVMLS1 






Entry Point or 
Control Section 
Name 

V — 

VM7900 
VM7950 
XIIB32 
XTTEAO 
XTTEA1 

XTTEB3 
XTTPOO 
XSTRDJ 
XUUBOO 
XUUH06 

X33B42 

X55C86 

X55D3G 

YPPMSG1 

YPPMSG2 

XPS631 

ZG0E60 

ZK0D1 

ZK0E1 

ZPOQM 

ZPQQMGBl 



Module Name 



IEFVMLSl 
IEFVMLSl 
IEFX5000 
IEFXT002 
IEFXT002 

IEFXT002 
IEFXTOOD 
IEFXT002 
JEFXT003 
IEFXT003 

IEFX300A 
IEFX5000 
IEFX5000 
IEFYPMSG 
IEFYPMSG 

IEFZHMSG 
IEFZHMSG 
IEFZHMSG 
IEFZHMSG 
IEFZGJB1 
IEFZGST1 
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IEAASTOO: Supervisor - STAE Service 
Routine 

This routine is entered when the STAE macro 
instruction (SVC 60) is issued. It 
creates, cancels, or overlays a STAE con- 
trol block according to the options speci- 
fied. It prepares the task to intercept 
the scheduled abnormal termination (ABEND) 
processing. 

• Entry ; IGC00060 

• Attributes ; Non-resident, reentrant 

• Control Section; IGC00060 



IEAATMOA: Supervisor — ABEND Linkage 
Routine 

This routine checks for valid and invalid 
recursions. For an invalid recursion, con- 
trol is passed to the Damage Assessment 
Routine. For a valid recursion, a bit is 
set in the TCBFLGS field of the TCB to pre~ 
vent an ABDUMP from being attempted. IEAA- 
TMOA determines the amount of main storage 
required by ABEND, and transfers control to 
the appropriate ABEND load module. 

• Entry ; IGCQ1HC 



• Exits; 



XCTL to IEAATM02 if main 
storage must be 
■stolen* 

to IEAATM03 if main 

storage is available 
and an indicative dump 
is requested 

to IEAATM04 if main 

storage is available 
and AEDUMP is requested 

to IEAATM05 if main 

storage is available 
and no dump is 
requested 

to IEAGTM08 if the sched- 
uler is failing and no 
ABDUMP is requested 



• Attributes ; Reentrant, disabled for 
external and I/O interruptions, 
privileged 



• Control Section: 



IGC0111C 



IEAATMOB; Supervisor - ABEND/ STAE 
Interface Routine 

This routine is the first ABEND/STAE Inter- 
face load module to receive control from 
the ABEND routine when abnormal termination 
has been scheduled for a task operating in 
a STAE environment. 

• Entry ; IGC0B01C 



• Attributes ; Non-resident, reentrant 

• Control Section ; IGC0B01C 

I EAATMOC: Supervisor - ABEND/STAE 



Interface Routine 



• Entry ; IGC0C01C 

• Attributes ; Non-resident, reentrant 

• Control Section ; IGC0C01C 

IEAATMOD: Supervisor - ABEND/STAE 
Interface Routine 



• Entry ; IGC0D01C 

• Attributes ; Non-resident, reentrant 

• Control Section: IGC0D01C 



I EAATMOE: Supervisor - ABEND/STAE 
Interface Routine 



• Entry ; IGC0E01C 

• Attributes ; Non-resident, reentrant 

• Control Section: IGC0E01C 



IEAATM01: Supervisor — ABEND Validity 
Check Routine 

This routine performs validity checking of 
the MSS (main storage supervisor) queue, 
the load list, the active RB list, and the 
DEB queue. It dequeues invalid control 
blocks, or terminates the queue at the 
point of error, and sets bits in the ABEND 
appendage to the boundary box to indicate 
invalid control blocks found on one or more 
lists. 

• Entry : IGC0101C 

• Exit: XCTL to IEAATMOA 

• Attributes : Reentrant, disabled for 
external and I/O interruptions, 
privileged 

• Control Section : IGC0101C 

IEAATM02: Supervisor — ABEND Steal IRB 
Main Storage Routine 

This routine 'steals 1 main storage needed 
for ABEND functions that cannot be obtained 
via a GETMAIN macro instruction. The main 
storage is stolen from programs represented 
by LRBs on the loaded program list. 
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• Entry : IGC0201C 

• Exits ; XCTL to IEAATM2A if there is no 

loaded program list or 
if enough main storage 
is not available from 
the LRBs 
to IEAATM2E if IEAATM02 
has acquired the neces- 
sary main storage 

• Attributes : Reentrant, disabled for 
external and I/O interruptions, 
privileged 

• Control Section: IGC0201C 



• Exits : XCTL to IEAATM03 if indicative 

dump is requested 
to IEAATM04 if ABDUMP is 

requested 
to IEAGTM05 if no dump is 
requested or if a dump 
was previously 
attempted and failed 

• Attributes : Reentrant, disabled for 
external and I/O interruptions, 
privileged 

• Control Section: IGC0211C 



IEAATM2B : 
Routine 



Supervisor — ABEND LRB Stack 



IEAATM03 : Supervisor 
Dump Routine 



ABEND Indicative 



This routine accumulates the information 
for an indicative dump and stores it in 
main storage. 



This routine moves the LRBs whose main 
storage was stolen by IEAATM02 to conti- 
guous locations in the low end of the freed 
area and resets the chain pointers in the 
LRBs. 

• Entry : IGC0221C 



• Entry : IGC0301C 

• Exit : XCTL to IEAGTM05 

• Attributes : Reentrant, disabled for 
external and I/O interruptions, 
privileged 

• Control Section : IGC0301C 

IEAATM04: Supervisor — ABEND/ABDUMP 
Routine 

This routine determines if the user wants a 
full or partial ABDUMP, initiates the 
ABDUMP output, and calls an SVC 51 

(ABDUMP) . 



• Exits : XCTL to IEAATM03 if indicative 

dump is requested 
to IEAATM04 if ABDUMP is 

requested 
to IEAGTM05 if no dump is 
requested or if a dump 
was previously 
attempted and failed 

• Attributes : Reentrant, disabled for 
external and I/O interruptions, 
privileged 



• Control Section: 



IGC0221C 



IEAGENQl: 
Routine 



Supervisor — Enqueue Service 



• Entry : IGC0401C 

• Exits : XCTL to IEAATM03 for an indica- 

tive dump if the DCB 
has failed to open 
to IEAGTM05 for initiali- 
zation of the next task 

• Attributes : Reentrant, disabled for 
external and I/O interruptions, 
privileged 



• Control Section: 



IGC0401C 



IEAATM2A: Supervisor — ABEND Steal 
Problem Program Main Storage Routine 

This routine "steals' main storage needed 
for ABEND functions from the lower end of 
the partition when it cannot be acquired 
either by a GETMAIN macro instruction or by 
the steal routine provided by IEAATM02. 

• Entry : IGC0211C 



This routine constructs and processes con- 
trol blocks to serialize the use of 
resources in a multiprogramming environ- 
ment. 

• Entry : IEAGENQl 

• Exit : EXIT routine or to the 
dispatcher 

• Tables/Work Areas : Minor QCB, Major 
QCB, Queue element 

• Attributes : Reenterable 

• Control Sections : IGC048 and IEG056 

IEAGENQ2: Supervisor — Shared DASD 
Enqueue Service Routine 

This routine is the enqueue service routine 
for systems that include the Shared DASD 
option. It is identical to IEAGENQl except 
that additional processing is performed 
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when a shared direct-access device is 
requested through the RESERVE macro 
instruction. 

• Entry : IEAGENQ2 

• Exits : EXIT routine or to the 
dispatcher 

• Tables/Work Areas : Minor QCB, Major 
QCB, Queue element 

• Attributes : Reenterable 

• Control Sections: IGC048 and IEG056 



IEAGTM0A: Supervisor — ABEND STAE Test 
Routine 

This routine prevents asynchronous exits 
and stores the completion code (if not pre- 
viously stored) . It determines if control 
should be returned to STAE after a purge 
error, if the Graphics Abend Exit routine 
should be entered, and if a valid STAE is 
in effect. 



• Attributes : Reentrant, disabled for 
SVC interruptions, privileged 



Entry : 



IGC0001C 



Exits : XCTL to IEAGTMOO to continue 
AEEND processing 

to IEAATMOB if a valid STAE 
is in effect 

to IEAGTM08 if an invalid 
ABEND recursion or a 
primary DAR recursion 
has occurred 

to IEAGTM09 if a secondary 
DAR recursion has 
occurred 

to IEAATMOB if an ABEND was 
issued by the Purge rou- 
tine during STAE 
processing 
EXIT to caller if graphics 
program 

Attributes : Reentrant, disabled, 
privileged 

Control Section: IGC0001C 



IEAGTMOO: 



Supervisor — AEEND 



Initialization Routine 

This routine provides purging for IQEs and 
WTOR requests, and cancels the task timer 
element. 

• Entry : IGC0701C 

• Exit : XCTL to IEAATMOD if IEAGTMOO was 

entered from STAE 
to IEAGTM05 if this is a 

normal end 
to IEAGTM06 if this is an 

abnormal end 



• Control Section: 



IGC0701C 



IEAGTM05: Supervisor — ABEND Termination 
Routine 



This routine closes all data sets, purges 
the timer queue, resets the TCB fields, 
frees main storage, and transfers control 
to the job scheduler. 

• Entry : IGC0501C 

• Exits : XCTL to IEFSD51K for scheduler- 

size partitions 
to IEFSD599 for small 
partitions 

• Attributes : Reentrant, disabled for 
external and I/O interruptions, 
privileged 

• Control Section: IGC0501C 



I EAGTM06: Supervisor — ABEND Input/Cutput 
Purge Routine 



This routine purges I/O operations in pro- 
cess and outstanding I/O requests. 

• Entry : IGC0601C 

• Exit : XCTL to IEAATM01 for normal exit 

to IEAGTM0.9 if a system 
task or "must complete" 
task 

• Attributes : Reentrant, disabled for 
I/O and external interruptions, 
privileged 

• Control Section: IGC0601C 



I EAGTM08: Supervisor — DAR Core Image 
Dump Routine 



This routine attempts to write a core image 
dump to a preallocated data set. It also 
processes primary DAR recursions. 

• Entry : IGC0801C 

• Exits : XCTL to IEAGTM05 if called for 

a dump only 
to IEAGTM09 to continue 
DAR processing 

• Attributes : Refreshable, disabled, 
privileged 

• Control Section: IGC0801C 
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IEAGTM09; Supervisor — EAR Task 
Reinstatement: Routine 

This routine attempts reinstatement of 
failing system tasks. It also processes 
secondary DAR recursions and failing tasks 
which are in "Must Complete" status. 



Entry : 



IGC0901C 



• Exits ; XCTL to IEAGTM05 for non-system 

task with or without 
non-critical resources 
Branch to dispatcher for secon- 
dary DAR recursion, 
critical resources, or 
system task failure. 

• Attributes ; Refreshable, disabled, 
privileged 

• Control Section ; IGC0901C 

IEA0TI01; Supervisor — Timer Second Level 
Interruption Handler 

This routine maintains the timer queue when 
the timer option is not specified during 
system generation. It handles only the 
normal six hour interruptions. 

• Entry ; IEAOTIOl 

• Exit ; To Timer/External FLIH 

• Tables/Work Areas ; SHPC, T4PC, LTPC 

• Attributes ; Reenterable, disabled for 
system interruptions, resident, super- 
visor mode 

• Control Section ; IEAOTIOl 

IEECIR50; Master Scheduler — Wait/Router 
Routine 

This routine waits until a command is 
issued, analyzes the command and passes 
control to the appropriate processing 
module. 

• Entry ; IEECIR50 

• Exits ; IEESD562, IEEDFIN1 

• Attributes ; Read-only, reenterable, 
resident in nucleus. 

• Control Section ; IEECIR50 

• Page Reference ; 49 

IEECMAWR; Communications Task — Router 
Module 

This module waits for the posting of a com- 
munications task EGB, determines the type 
of interruption service required (external. 



attention, I/O, WTO, or DOM) , and passes 
control to other communications task 
modules for further processing. 

• Entry ; IEECMWRT 

• Exit ; IEECMCSW, IEECMDSV, IEECMWSV, 
IEECMWTL, IEECMDOM, Dispatcher 

• Tables/Work Areas ; CVT, EIL, UCM, WQE 

• Attributes ; Reentrant, refreshable 

• Control Section ; IEECVCTW 

IEECMCSW; Communications Task — Console 
S witch Module 

This routine provides console switching as 
a result of an unrecoverable I/O error on a 
console device, as a result of an external 
interruption, or as a result of a VARY com- 
mand, and provides hard copy switching from 
a console device of SYSLOG. 

• Entry ; IGCXL07B 

• Exit; IEECMAWR, IEECMDSV 

• Tables/work Areas ; CVT, CXSA, RQE, 
UCM, WQE 

• Attributes ; Reentrant, refreshable 

• Control Sections ; IGCXL07B, IGCXM07B, 
IGCXN07B, IGCXC07B 

IEECMDOM; Communications Task — DOM 
S ervice Module 

This module marks for deletion specified 
WQEs on the system output queue. 

• Entry ; IEECMDOM 

• Exit ; IEECMAWR, IEECVDT1 

• Tables/Work Areas ; CVT, DCM, UCM, WQE 

• Attributes ; Reentrant, refreshable 

• Control Section ; IEECMDCM 

I EECMDSV; Communications Task — Device 
Service Module 

This module provides the interface with 
device support processors and provides con- 
sole and system output queue management. 

• Entry ; IEECMDSV 

• Exit; IEECMAWR, IEECMWSV, IEECMCSW, 
Device Support Processors 

• Tables/Work Areas ; IEEBASEB, CVT, EIL, 
UCM, WQE 
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• Attributes : Reentrant , refreshable 

• Control Section : IEECMDSV 

IEECMWSV: Communications Task — WTO(R) 



Service Module 



This module puts unprocessed WQEs on appro- 
priate console output queues 

• Entry : IEECMWSV 

• Exit : IEECMDSV, IEECMAWR 

• Tables/Work Areas : UCM, WQE 

• Attributes : Reentrant , refreshable 

• Control Section: IEECMWSV 



IEECMWTI: Communications Task 



NIP 



Message Buffer Writer Module 

This module issues SVC 36 to write NIP mes- 
sages to SYSLCG. If SYSLOG has not been 
initialized or not specified as the hard 
copy log f it issues SVC 35 to write the NIP 
messages to the operator. 

• Entry : IEECMWTL 

• Exit: Return to caller 



• Control Section: IGC0907B 



IEECVCRA: Communications Task 



Console 



Interruption Routine 

This routine notifies the wait routine that 
a console read has been requested. 

• Entry s IEEBA1 

• Exit : Return to IOS 

• Tables/Work Areas : ECE, UCM, UCE 

• Attributes : Reenterable 

• Control Section : IEEEA1 

• Page Reference : 44 

IEECVCRX: Communications Task — External 
Interruption Routine 

This routine switches control from the pri- 
mary console device to an alternate console 
device when an external interruption 
occurs. 

• Entry : IEEBC1PE 

• Exit: Return to IOS 



• Tables/Work Areas : UCM 

• Attributes : Reenterable 

• Control Section : IEEBC1PE 

• Page Reference : 45 

I EECVCTE: Communications Task — User 
D ummy WTQ/WTQR Exit Routine 



This routine takes the place of the user's 
WTO/WTOR exit routine when an exit routine 
was specified at system generation , but 
none was supplied. 

• Entry: IEECVXIT, from IEECMWSV 

• Exit : Return to caller 

• Control Section : IEECVXIT 

I EECVCTI: Console Initialization Routine 

This routine prints out the NIP message 
buffer in systems with the MCS option, and 
initializes the console configuration. 

• Entry : IEECVCTI, from IEESD569 

• Exit : To IEESD569 

• Tables/Work Areas : CVT f EIL f UCB, and 
UCM 

• Attributes : 

• Control Section : IEECVCTI 

I EECVCTR: Communications Task — Router 
Routine 

This routine determines the type of request 
or interruption that occurred, and passes 
control to the appropriate processing 
routine. 

• Entry : IEECVCTR 

• Exits : XCTL to IEECVPMX (IGC0107B) , 
IEECVPMC (IGC1107B), or IEECVPMP 
(IGC2107B) 

• Tables/Work Areas : UCM, SVRB, UCB 

• Attributes : Reenterable 

• Control Section : IEECVCTR 

• Page Reference : 44 

I EECVCTW: Communications Task — Wait 
Routine 

This routine waits on all communications 
task ECBs associated with WTC/WTOR macro 
instructions . 
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• Entry ; IEECIR45 



• Exit: 



None 



• Tables/Work Areas : TCB, ECB, UCM 

• Attributes : Reenterable 

• Control Section : IEECIR45 

• Page Reference : 44 

IEECVED2: Communications Task — Purge RQE 
Routine 

This routine scans and purges all outstand- 
ing reguest gueue elements (RQEs) pertain- 
ing to the terminating task. 

• Entry : IEECVPRG 

• Exits : End-of-task, and ABEND 

• Tables/Work Areas : RQE f WQE f JCM, CVT 

• Attributes : Reenterable 

• Control Section : IEECVPRG 

IEECVPM: Communications Task — Console 
Device Processor Routine 

This routine performs console read and 
write operations and checks for errors. 

• Entry : IEECVPM 

• Exit : XCTL to IEECVCTR (IGC0007B) 

• Tables/Work Areas : DCE, UCB f UCM 

• Attributes : Reenterable 

• Control Section : IEECVPM 

• Page Reference : 44 

IEECVWTO: Communications Task — 
Write- to- Operator Routine 

This routine processes all WTO macro 
instructions. 

• Entry : IGC0003E 

• Exit : Return to calling program 

• Tables/Work Areas : WQE, UCM, CVT f RQE 

• Attributes : Reenterable 

• Control Section : IGC0003E 

• Page Reference : 45 



I EEDFIN1: Master Scheduler — DEFINE 
C ommand Initialization Routine 

This routine sets up data areas for parti- 
tion definition, issues a DEFINE COMMAND 
BEING PROCESSED message to all active con- 
soles, and passes control to the appropri- 
ate processing module. 

• Entry : IEEDFIN1 

• Exits : IEEDFIN3, IEEDFIN4 , IEEDFIN5 

• Attributes : Read-only, reenterable 

• Control Section: IEEDFIN1 



• Page Reference : 
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I EEDFIN2: Master Scheduler — DEFINE 
C ommand Syntax Check and Router Routine 

This routine checks the syntax of DEFINE 
command statements. If a syntax error is 
discovered, the statement is ignored and an 
error message is issued. If the syntax is 
correct, the information is stored and con- 
trol is passed to the appropriate routine. 

• Entr y: IEEDFIN2, IEEDPART 

• Exits : IEEDFIN5, IEEDFIN6, IEEDFIN7 

• Attributes : Read-only, reenterable 

• Control Section : IEEDFIN2 

• Page Reference : 50 

I EEDFIN3: Master Scheduler — DEFINE 
Command Validity Check Routine 

This routine determines that all informa- 
tion for the partition redefinition is 
correct, and passes control to the appro- 
priate processing routine. 

• Entry: IEEDFIN3 

• Exits : IEEDFIN8, IEEREXIT 

• Attributes : Read-only, reenterable 

• Control Section : IEEDFIN3 

• Page Reference : 52 

I EEDFIN4: Master Scheduler — DEFINE 
Command Listing Routine 

This routine lists partition definitions. 

• Entry : IEEDFIN4 

• Exits: IEEDFIN3, IEEDFIN5 

• Attributes : Read-only, reenterable 
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• Control Section: IEEDFTN4 



• Page Reference : 52 



IEEDFIN5: Master Scheduler — DEFINE 
Command Message Routine 

This routine contains texts for operator 
messages required for DEFINE command pro- 
cessing. The message is constructed 
according to a code passed by the calling 
routine. IEEDFIN5 issues the requested 
message and passes control to IEEDFIN2 or 
the dispatcher. 

• Entry : IEEDFIN5 

• Exits : IEEDFIN1, IEEDFIN2 or return to 
calling program 

• Attributes : Read-only, reenterable 

• Control Section : IEEDFIN5 

• Page Reference : 52 



IEEDFIN6: 



Master Scheduler — Time- Slice 



Syntax Check Routine 

This routine checks the TMSL subparameters 
for proper syntax. 

• Entry : IEEDFIN6 

| • Exits : IEEDFIN2, IEEDFIN5, IEEDPART 

• Attributes : Read-only, reenterable 

• Control Section : IEEDFTN6 

• Page Reference : 52 



IEEDFIN7: Master Scheduler — Keyword Scan 
Routine 

This routine checks keyword parameters for 
syntax errors. If a syntax error is disco- 
vered, the erroneous entry and all follow- 
ing entries are ignored, and an error mes- 
sage is generated. If the syntax is 
correct, the information is stored. 

• Entry : IEEDFIN7 

• Exits : IEEDFIN2, IEEDFIN3, IEEDFIN4, 
| IEEDFIN5, IEEDPART 

• Attributes : Read-only, reenterable 

• Control Section : IEEDFIN7 

• Page Reference : 52 



I EEDFIN8: Master Scheduler — System 
R einitialization Routine 

This routine checks the redefinition infor- 
mation to assure that the request is valid. 
It no error is found, this routine con- 
structs a list of ECBs (one for each of the 
affected partitions) to be posted when the 
jobs in the partitions have terminated. It 
enqueues on the partition boundary boxes, 
updates system control blocks and the 
affected boundary boxes, and then dequeues. 

• Entry : IEEDFIN8 

• Exits: IEEDFIN9, IEEREXIT 

• Attributes : Read-only, reenterable 

• Control Section : IEEDFIN8 

• Page Reference : 53 



IEEDFIN9: Master Scheduler 



Command 



Final Processor Routine 

This routine issues a message to all active 
consoles that processing is complete and 
updates the task control blocks affected by 
time- slicing if time- slicing is specified. 

• Entry: IEEDFIN9 

• Exits : IEEDFIN5 

• Attributes : Read-only, reenterable 

• Control Section: IEEDFIN9 



• Page Reference : 53 



I EELQG02: Master Scheduler — Log Open 
Initialization Module 



This routine opens the system log at IPL 
time. 

• Entry: IEELOG02 

• Exit: IEESD569 

• Tables/ Work Areas : CVT, UCB, UCM, 
TIOT, M/S resident data area, JFCE, 
IEELCA, DCB. 

• Attributes : Refreshable 

• Control Section : IEEICG02 

I EELWAIT: Master Scheduler — Log Wait and 
W riter Module 

This module writes data from the log buffer 
to the system log. 

• Entry : IEELWAIT 
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• Exit : To Dispatcher 

• Tables/Work Areas ; CVT, LCA, MRC 

• Attributes : Resident 

• Control Section: IEELWAIT 



IEEPDISC: Display Consoles Get Region 
Routine 

This routine obtains a region of main 
storage, and sets up an environment for the 
execution of the DISPLAY CONSOLES command, 
and then frees the region when control is 
returned. 

• Entry : IEEPDISC, from IEEVATT1 

• Exit : To IEEXEDNA, Return to Master 
Task (SVC 3) 

• Attributes : Read-only, reentrant , 
resident 

• Control Sections: IEEPDISC 



IEESD561: SVC 34 — START and STOP INIT 
Routine 

This routine processes the START and STOP 
INIT commands. 

• Entry : IGC1903D 

• Exit : Return to caller, or to IEE0503D 
for an error message 

• Tables/Work Areas : CSCB, PIB, M/S 
resident data area, CVT, XSA 

• Attributes : Reenterable, Transient 
read- only 

• Control Section : IGC1903D 

• Page Reference : 47 



IEESD562: Master Scheduler — Syntax Check 
Routine 

This routine checks syntax of the command 
and sets internal codes for queue search, 
if required. 



Entry : 



IEESD562 



• Exits : XCTL to IEESD563 for queue 
search, to IEESD566 for DISPLAY active, 
or to IEEXEDNA for DISPLAY CONSOLES 

• Attributes : Read-only, reenterable 

• External References: None 



• Control Section: IEESD562 



• Page Reference : 49 



I EESD563: Master Scheduler — Queue Search 
S etup Routine 

Ihis routine determines which queue is to 
be searched, reads and scans the queue con- 
trol record, establishes parameters for the 
search, and transfers control to the queue 
search module. IEESD563 will write out 
updated queue control records. 

• Entry : IEESD563 

• Exits : XCTL to IEESD564 to search 
queue; XCTL to IEESD565 at completion 

• Tables/Work Areas : QCR, QMPA, CVT, 
CSCB 

• Attributes : Read-only, reenterable 

• Control Section : IEESD563 

• Page Reference : 49 



I EESD564: Master Scheduler — Queue Search 
Module 

This routine searches the work queues for 
the execution of the queue manipulation 
commands. 

• Entry : IEESD564 

• Exit : XCTL to IEESD563 

• Tables/Work Areas : QCR, CSCB, CVT, 
QMPA, XSA 

• Attributes : Read-only, reenterable 

• Control Section : IEESD564 

• Page Reference : 49 

IEESD565: Master Scheduler — Service 
R outine 

This routine frees storage obtained by 
IEESD563, links to the gueue manager to 
engueue an entry or gueue control record on 
SYS1- SYSJOBQE, or links to write a message. 

• Entry : IEESD565 

• Exit : Return to caller 

• Tables/Work Areas : QMPA, CSCB, QCR, 
CVT 

• Attributes : Read-only, reenterable 



Appendix B: MFT Modules 119 



• External References : IEF2MNQ2, 
IEE0503D 

• Control Section : IEESD565 

• Page Reference : 49 

IEESD566: Master Scheduler — DISPLAY A 
Routine 

This routine builds a table and constructs 
operator messages according to the proces- 
sing required by a DISPLAY A command. 

• Entry : IEESD566 

• Exit : Return to caller (IEECIR50) 

• Tables/Work Areas : QMPA, CSCB, XSA, 
QCR f CVT 

• Attributes : Read-only, reenterable 

• Control Section : IEESD566 

• Page Reference : 50 

IEESD568: Nucleus — Master Scheduler 
Resident Data Area 

This routine contains the master scheduler 
resident data area. 

• Entry : IEEMSER 

• Exit: None 

• Attributes : Not reusable 

• Control Section : IEEMSER 

• Page Reference : 87 



IEESD571: SVC 34 — DEFINE, MOUNT, CANCEL 
Routine 

This routine schedules the execution of the 
DEFINE, MOUNT, and CANCEL (for active jobs 
only) commands. 



• Attributes: Reenterable 



• Control Section: 



IGC1803D 



j • Entry : IGC1803D 



• Exits: 

MOUNT - XCTL to IGC0103D 

DEFINE - Return to caller 

CANCEL - Active and cancelable — 
Enter ABTERM to force 
cancel 
Active and not cancelable — 
POST and mark CSCB inac- 
tive; XCTL to IEE0803D 

XCTL to IEE0503D and IEE2103D due to 
error. 

• Tables/Work Areas : CSCB, PIB, M/S 
resident data area, CVT 



• Page Reference : 47 



IEESD590: System Task Control — Write 
TIOT on Disk 

This routine writes the TIOT which is used 
by Job Selection (IEESD510) and checks for 
a small partition writer. 

• Entry : IEESD590 

• Exits : XCTL to IEFSD510 (small parti- 
tion writer) or XCTL to IEFSD591 

• Tables/Work Areas : TIOT, SPIL 

• Attributes : Reenterable 

• Control Section : IEESD590 

• Page Reference : 75 



IEESD591: System Task Control — Linker 
Routine 

This routine transfers control between sys- 
tem task control and an interpreter or sys- 
tem output writer. 

• Entry : IEESD591, IEE591SD 

• Exit : XCTL to IEEVTCTL 

• Tables/Work Areas : CSCB, CVT, PIB, 
IWA, QMPA 

• Attributes : Reenterable 

• Control Section : IEESD591 

• Page Reference : 75 



IEESD592: System Task Control — POST 
Routine 

This routine checks for an error indication 
in the CSCB. It posts the error condition 
or a valid condition. 

• Entry : IEESD592 

• Exit : XCTL to IEFSD510 

• Tables/Work Areas : None 

• Attributes : Reenterable 

• Control Section : IEESD592 

• Page Reference : 75 
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IEEVACTL: System Task Control — 
Allocation Interface Routine 

This routine sets up the interface between 
system task control and the I/O device 
allocation routine. 

• Entry : IEEVACTL 

• Exits ; To IEFSD21Q, IEEVMSG1, 
IEEVSMSG, IEEVTCTL, or IEEVRWTC 

• Attributes ; Reenterable 

• Control Section ; IEEVACTL 

• Page Reference ; 75 



IEEVICLR: System Task Control — Internal 
JCL Reader 

This routine reads the internal job control 
language used in starting a reader or 
writer. 

| • Entry ; IEEVICLR, IEFICR 

• Exit ; Return to caller 

• Tables/Work Areas ; DCBD 

• Attributes ; Read-only, reenterable 

• Control Section; IEEVICLR 



IEEVJCL; System Task Control — JCL Edit 
Routine 

This routine constructs the internal job 
control language used in the START reader 
and START writer command execution 
routines. 



• Entry ; IEEVJCL, from IEEVSTRT 

• Exit ; XCTL to IEERCTL 

• Tables/Work Areas ; SDT, CSCD 

• Attributes ; Reenterable 

• Control Section ; IEEVJCL 

IEEVLDSP; Master Scheduler — Log 
Dispatcher Routine 



This routine puts the log data set on the 
system output queue. 

• Entry ; IEEVLDSP 

• Exit ; Master Scheduler 

• Tables/Work Areas ; IEEBASEA, CT, IEEL- 
CA f UCB, JFCB. 



• Attributes; Reentrant 



• Control Section; IEEVLDSP 



I EEVLIN: Master Scheduler — Log 
Initialization Routine 



Ihis routine initializes the system log. 

• Entry; IEEVLIN 

• Exit ; IEESD569, IEEVLIN2 

• Tables/Work Areas ; UCM, CVT, UCB, 
TIOT, M/S resident data area, IEELCA. 

• Attributes ; Refreshable 

• Control Section; IEEVLIN 



I EEVLNKT: System Task Control — 
L ink-Table Module 

This routine contains the table of routines 
that is scanned by IEEVACTL as a validity 
check for program linking. 

• Entry ; IEEVLNKT 

• Attributes ; Non-executable 

• Control Section ; IEEVLNKT 

I EEVLOUT: Log Data Set Reinitialization 
Routine 

This routine opens and closes the log data 
set to reinitialize the DS1LSTAR and 
DS1TRBAL fields of the DSCB associated with 
the log data set. 

• Entry ; IEEVLOUT, from IEFSD171 

• Exit ; IEFSD171 

• Tables/Work Areas ; CVT f DSCB, LCA, M/S 
Resident Data Area 

• Attributes ; Reenterable 

• Control Section; IEEVLOUT 



I EEVMSG1; System Task Control — Message 
W riter Routine 

This routine writes messages to the opera- 
tor as required by system task control. 

• Entry ; from IEEVRCTL, IEEVACTL, or 
IEEVTCTL 

• Exit ; Return to caller 

• Control Section: IEEVMSG1 
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IEEVOMSG: System Task Control — Message 
Writing Routine 

This routine assembles and writes messages 
to the operator. 

• Entry : IEEVOMSG 

• Exit : Return to caller 

• Control Section: IEEVOMSG 



IEEVRCTL: System Task Control 
Interpreter Control Routine 



This routine provides an interface between 
system task control and an interpreter. 

• Entry : IEEVRCTL 

• Exits : To IEFVH1 and IEEVACTL 

• Tables/Work Areas : CVT, CSCB 

• Control Section : IEEVRCTL 

• Page Reference : 74 



• Tables/Work Areas : QMPA, LCT, SMB, IOE 



• Control Section: IEEVSMBA 



IEEVSMSG: System Task Control — Message 
Writer Routine 

This routine writes messages to the opera- 
tor as reguired by the master scheduling 
task and system task control. 

• Entry: IEEVSMSG, from IEEVMSG1, 
IEFSD533, IEFUH1, or IEEVACTL 

• Exit: Return to caller 



• Control Section: IEEVSMSG 



IEEVSTAR: System Task Control — Start 
C ommand Syntax Check Routine 

This routine checks the syntax of a START 
command, and builds a start descriptor 
table (SDT) containing the parameters of 
the command. 



IEEVRFRX: Master Scheduler — Table Lookup 
Routine 

This routine can be used to obtain the fol- 
lowing information; the CVT address, the 
contents of a CVT entry, or the contents at 
the CVT pointer address, a pointer to the 
TCB or the RB, the TIOT pointer, the TIOT 
entry, the TIOT TTR, or the TIOT UCB point- 
er. The routine can also be used to insert 
a TIOT pointer, a TIOT TTR, or a TIOT UCB 
pointer in the CVT. 

• Entry : IEEVRFRX 

• Exit : Return to calling program 

• Tables/Work Areas : CVT, TCB, RB, TIOT, 
UCB 

• Attributes : Reenterable 

• Control Section: IEEVRFRX 



IEEVSMBA: System Task Control — QMPA 
Builder 

This routine constructs a gueue manager pa- 
rameter area (QMPA) referring to the mes- 
sage class gueue for the use of the I/O 
Device Allocation routine. 

• Entry : IEEVSMBA 

• Exit: To IEEVACTL 



• Entry : IEEVSTRT 

• Exits : To IEEVJCL, IEFSD533 , or 
IEE0503D 

• Tables/Work Areas : SDT, M/S Resident 
Data Area, CVT, M/S TIOT, UCB XSA, and 
CSCB. 

• Attributes : Reenterable 

• Control Section : IEEVSTRT 

• Page Reference : 74 



IEEVTCTL: System Task Control — 
lermination Interface Routine 

This routine initializes the necessary 
tables for terminating a task that was 
established via a START or MOUNT command. 

I • Entry : IEEVTCTL, from IEEVWILK, IEE- 
I VACTL or IEFW31SD 

• Exit : To IEFW42SD or IEEVOMSG, , then 
return to supervisor 

• Tables/Work Areas : TCB, JCT, SCT, LCT, 
and CSCB 

• Attributes : Reenterable. Character 
Dependence Type C 

• Control Section: IEEVTCTL 
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IEEVWTQR: Communications Task — 
Write- to- Operator With Reply Routine 

This routine processes all WTOR macro 
instructions. 

• Entry : IGC0103E 

• Exit : Return to calling program 

• Tables/Work Areas : WQE f RQE, UCM, CVT 

• Attributes : Reenterable 

• Control Section : IGC0103E 

• Page Reference : 45 



| • Control Section : IEE0303F 



IEEXEDNA: 



DISPLAY CONSOLES Processor 



This routine processes the DISPLAY command 
with the CONSOLES operand and displays the 
system console configuration on the re- 
questing console. 

• Entry : IEEXEDNA to IEESD562 

• Exit : To IEECIR50 

• Attributes : Reentrant 

• Control Sections : IEEXEDNA 

IEE0303D: SVC 34 — Translator/ Chain 
Manipulator 

This routine translates lowercase letters 
into uppercase, and manipulates the CSCB 
chain as requested by the caller of SVC 34. 

• Entry : IEE0303D 

• Exit : To IEE0403D, or return to caller 

• Tables/Work Areas : CVT, M/S resident 
data area, CSCB, XSA 

• Control Section : IEE0303D 
IEE0303F: SVC 36 — WRITE-TO-LOG 



This module copies text records from an 
input area to the log buffer and posts the 
log ECB when the buffer is full. 

• Entry : IEE0303F 

• Exit: Returns to Master Scheduler, 
IEE0403F. 

• Tables/Work Areas : IEEBASEA, IEELCA, 
CVT 

• Attributes: 



I EE0403D: SVC 34 — Router Routines 

This routine identifies the command verb, 
ensures that the console has authority to 
enter the command, and passes control to 
the appropriate routine. 

IEE0403D 

• Exit : Depending on command verb, via 
XCTL to another SVC 34 module 

• Tables/ Work Areas : M/S resident data 
area, XSA, CSCB 

• Control Section : IEE0403D 

• Page Reference : 47 



IEE0403F: SVC 36 (Load 2) — Log Buffer 
M anagement Module 



This module opens, closes, and switches 
system log buffers. 



Entry : IEE0403F 



• Exit: IEE0303F 



• Tables/ Work Areas : IEEBASEA, IEELCA, 
UCB, JFCB,, DCB, CVT, TICT. 



• Attributes : Reentrant 

• Control Section : IEE0403F 

I EE0503D: SVC34 — Message Assembly 
Routine 

This routine assembles and edits messages 
for the command scheduling routine, and 
writes the messages to the operator. 

• Entry : IEE0503D 

• Exit : Branch on register 14 

I • Attributes : Reenterable, read-only 

• Control Section : IEE0503D 
I EE0603D: SVC 34 — SET Command Routine 
This routine processes the SET command. 

• Entry : IEE0603D 

J • Exits : To IEE0903D, IEE0503D, or 
j return to caller 



Appendix B: MFT Modules 123 



• Tables/Work Areas : XSA, CVT, M/S resi- 
dent data area 

• Attributes : Reenterable, self- 
relocating, read only transient 

• Control Section: IEE0603D 



IEE0703D: SVC 34 — CSCE Marking Routine 

This routine schedules the execution of the 
ST0F and MODIFY commands by finding and 
updating the appropriate CSCE and by issu- 
ing a POST macro instruction to the master 
scheduling task. 

• Entry : IEE0703D 

• Exits : Branch on register 14, or XCTL 
| to IEE0803D, IEE0503D or IEE2103D. 

• Tables/Work Areas : M/S Resident Data 
| Area, XSA, CVT, CSCE, SPL 

I* Attributes : Reenterable, self- 
relocating, read-only, transient 

• Control Section: IEE0703D 



IEE0803D: SVC34 — CSCB Creation Routine 

This routine schedules the execution of 
commands that cannot be completely pro- 
cessed by the command scheduling routines. 
It performs this function by adding a CSCB 
to the CSCB chain and issuing a POST macro 
instruction to the master scheduling task. 
It also processes the DISPLAY T command. 



• Attributes : Reenterable, supervisor 
state, disabled for system interrupts, 
transient 



Entry : 



IEE0803D 



• Exit : IEE0503D, IEE2103D, IEE2903D, or 
return to caller 

• Tables/Work Areas : XSA, M/S resident 
data area, CVT, CSCB, and UCM 

• Attributes : Reenterable, transient, 
partially disabled. 

• Control Section: IEE0803D 



IEE0903D: SET Command Handler 

This routine processes the date and time 
operands of the SET command . 

• Entry : IEAQOT00 

• Exit : SVC 3 

• Tables/Work Areas: CVT 



• Control Section: 



IEAQCTOO 



IEE1103D: SVC 34 — VARY and UNLOAD Scan 
and Router Routine 



This routine examines the command and its 
operand and routes the command to the 
appropriate processing module. 

• Entry : IEE1103D 

• Exit : IEE2303D for VARY ONLINE, CNGFX, 
and CONSOLES operands when SMF is pre- 
sent, to IEE3103D for all other VARY 
operands and UNLOAD, and to IEE0503D 
for errors. 

• Tables/Work Areas : XSA, CVT, M/S resi- 
dent data area, and UCM. 

• Attributes : Reenterable, self- 
relocating, read-only, and transient. 

• Control Sections : IEE1103D 

IEE1203D: SVC 34 — Reply Processor 

This routine checks the validity of the 
operator's reply command, and moves the 
operator's reply (if valid) to the buffer 
of the user that issued the respective 
ViTOR. 

• Entry: IEE1203D 

• Exit : Return to caller 

• Tables/Work Areas : CVT, UCM, WQE, RQE, 
CXSA 

• Attributes : Reenterable 

• Control Section: IEE1203D 



IEE1403D: 



SVC 34 — HALT Routine 



This routine schedules the execution of the 
HALT command by adding a CSCB to the CSCB 
chain and by issuing a POST macro instruc- 
tion to the master scheduling task. 

• Entry : IEE1403D 

• Exit : IFBSTAT 

• Tables/Work Areas : XSA, M/S resident 
data area,, CVT, and CSCB 

• Attributes : Reenterable 

• Control Section: IEE1403D 
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IEE1603D: SVC 34 — Log and Writelog 
Processor Routine 



This routine issues a WTL macro instruction 
when a ICG command is issued, and stores 
the WRITELCG command and posts the Log ECB, 
for WRITELCG processing. 

• Entry : IEE1603D, from IEE0403D 

• Exit : IEE0503D for errors, and return 
to caller of SVC 34. 

• Tables/Work Areas : XSA, CVT, LCA, and 
M/S resident data area. 

• Attributes : Reentrant, self- 
relocating, read-only, and transient. 

• Control Sections: IEE1603D 



IEE1703D: SVC 34 — VARY ONGFX/OFFGFX 



This routine processes the GVARY command. 
It checks the parameters for validity and 
if an error is found, it passes control to 
IEE0503D via an XCTL macro instruction. If 
the parameters are valid, the routine sets 
appropriate bits in the Overall Control 
Table (CCT) of the GFX reader task. It 
then issues a POST macro instruction on the 
ECB in the CCT for each graphics device 
(2250) placed in the online status. 

• Entry : IEE1703D 

• Exit : IEE0503D, return to issuer of 
SVC 34 

• Tables/Work Areas : CVT, OCT, XSA 

• Attributes : Reenterable, read-only, 
self-relocating 

• Control Section : IEE1703D 

IEE1A03D: SVC 34 — MCS Reply Processor 
Routine 

The purpose of this routine is to process 
valid operator replies to WTOR macro 
instructions . 

• Entry : IEE1A03D 

• Exit : To IEE1B03D to issue error mes- 
sages or return to the caller of SVC 
34. 

• Control Sections : IEE1A03D 

IEE1B03D: SVC 34 — MCS Reply Message 
Routine 

This routine assembles, edits, and broad- 
casts the accepted reply to a WTOR macro 
instruction for the MCS Reply Processor 



routine (module IEE1A03D) of the Command 
Scheduling routine, and to write error mes- 
sages to the operator whose command is in 
error. 

• Entry : IEE1B03D, from IEE1A03D 

• Exit : Return to the caller of SVC 34 

• Control Sections: IEE1B03D 



I EE2103D: SVC 34 — Message Assembly 
Routine 

This routine assembles and edits messages 
for the command scheduling routine, and 
writes the messages to the operator. 

• Entry: IEE2103D 

• Exit: Branch on register 14 

• Attributes : Reenterable, self- 
relocatory, read-only, transient 

• Control Section : IEE2103D 
IEE2303D: SVC 34 — SMF Processor 



This routine initially processes the 
ONLINE, ONGFX and CONSOLES operand of the 
VARY command when the system has the SMF 
option. It builds and issues an SMF record 
for each device placed in online status. 

• Entry : IEE2303D 

• Exit : IEE3103D 

• Tables/Work Areas : CVT, SMCA, XSA 

• Attributes : Reentrant, read-only, 
self -relocating 

• Control Sections: IEE2303D 



IFE2903D: 
Routine 



SVC 34 — Display Reguests 



Ihis routine displays to the requesting 
operator the ID of all outstanding WTCRs, 
the unit name of each device for outstand- 
ing MOUNT messages, and an indication as to 
whether any AVR mount messages are pending. 

• Entry : IEE2903D, from IEE0803D 

• Exit : Return to caller of SVC 34 

• Tables/Work Areas : Message work area 

• Attributes : Reentrant, Refreshable, 



transient 
• Control Sections: 



IEE2903D 
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IEE3103D: SVC 34 — Vary and Unload 



Processor Routine 



This routine processes the UNLOAD command, 
all VARY command operands in a system 
without the MCS option , and VARY ONLINE and 
OFFLINE operands for non-console devices in 
a system with the MCS option. In addition, 
it passes control to the appropriate MCS 
processors for processing of console 
devices. 



• Entry : IEE3103D, initially from 
IEE1103D or IEE2303D and returns from 
IEE4203D and IEE4603D. 

• Exit : IEE1703D for VARY ONGFX/OFFGFX, 
IEE4203D for VARY ONLINE/OFFLINE/ 
CONSOLES with no keywords after CON- 
SOLES, IEE4303D for VARY MSTCONS, 
IEE4403D for VARY HARDCPY/ CON SOLES with 
keywords, IEE4703D for VARY HARDCPY 
without keywords, IEE0503D for errors, 
Return to Caller of SVC 34 for UNLOAD. 

• Tables/Work Areas : XSA, UCM, CVT, M/S 
resident data area, and UCB. 

• Attributes : Reentrant, self- 
relocating, read-only, transient. 

• Control Sections: IEE3103D 



IEE4103D: SVC 34 
Issuing Routine 



Hardcopy Message 



This routine issues messages concerning the 
status of the hard copy log and frees 
storage obtained for those messages. 



• Entry : IEE4103D, from IEE4703D and 
IEE4803D 

• Exit : IEE4203D if multiple units spe- 
cified in VARY command and units remain 
to be processed, IEE0503D for errors, 
or return to caller of SVC 34 if all 
units have been processed 

• Tables/Work Areas : XSA, message area, 
UCB, CVT, XSA, and UCM 

• Attributes : Reentrant, transient 

• Control Sections: IEE4103D 



IEE4203D: SVC 34 — Vary Unit Field Scan 
and Router Routine 

This module performs authority and operand 
validity checking, and passes control to 
the routine that will process the command. 



• Entry: IEE4203D, from IEE3103D, 
IEE4103D, IEE4403D, and IEE4603D 

• Exit : To IEE3103D for processing VARY 
ONLINE/OFFLINE of non-console units, to 
IEE4603D for processing of VARY ONLINE/ 
OFFLINE CONSOLES of console units, and 
for processing when errors in syntax 
are found or when multiple units were 
specified and units remain to be pro- 
cessed, IEE4 903D for processing of VARY 
CONSOLES, and to IEE0503D and IEE2103D 
when other errors occur. 

• Tables/Work Areas : XSA, CVT, UCM, and 
UCB. 

• Attributes : Reentrant, self- 
relocating, read-only, transient 

• Control Sections : IEE4203D 
IEE4303D: SVC 34 — VARY MSTCCNS Routine 



This routine processes the VARY MSTCCNS 
command. 

• Entry: IEE4303D, from IEE3103D 

• Exit : To IEE0503D or IEE2103D on 
errors, SVC 72 to console Switch Rou- 
tine (module IEECMCSw) and upon return 
to caller of SVC 34 

• Tables/Work Areas : UCB, CVT, XSA, and 
UCM 

• Attributes : Reentrant, self- 
relocating, read-only, transient 

• Control Sections : IEE4303D 
IEE4403D: SVC 34 — Vary Keyword Scan 



R outine 

This routine determines the validity of 
VARY CONSOLE-HARDCPY keywords, and to set 
appropriate bits in the XSA. 

• Entry : IEE4403D, from IEE3103D 

• Exit: To IEE4203D if VARY CONSOLES, to 
IEE4703D if VARY HARDCPY, to IEE0503D 
if errors. 

• Tables/Work Areas : XSA, UCM, CVT, and 
UCB 

• Attributes : Reentrant, transient 

• Control Sections: IEE4403D 



IEE4503D: SVC 34 — Periodic STOP Command 



Handler Routine 



This routine processes the commands STOP 
JOBNAMES/STATUS/SPACE/DSNAME . 
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• Entry : IEE4503D, from IEE0403D 



• Exit ; IEE0503D for errors, and return 
to caller of SVC 34 



• Tables/Work Areas : XSA, M/S resident 
data area, CVT, and UCM 



Attributes ; Reentrant, self- 
relocating, read-only, transient 



Control Section; IEE4503D 



IEE4603D: 



SVC 34 — VARY ONLINE/OFFLINE of 



Consoles and Message Routing Routine 



This routine processes VARY ONLINE/OFFLINE 
for all MCS consoles and dispatches error 
messages for syntax errors. 



• Entry ; IEE4603D, from IEE4203D to pro- 
cess VARY ONLINE/OFFLINE or to dispatch 
WTOs, IEE4903D to dispatch WTOs. 

• Exit : IEE3103D when multiple units 
specified and only non-console units 
remain to be processed, IEE4203D if 
unit field indicates more console (and 
possible non-console) units remain to 
be processed, IEE0503D and IEE2103D for 
errors, return to caller of SVC 34 if 
all units have been processed. 

• Tables/Work Areas : XSA, CVT, UCB, UCM, 
and M/S resident data area . 

• Attributes : Reentrant, self- 
relocating, read-only, transient 

• Control Sections: IEE4603D 



IEE4703D: SVC 34 — VARY HARDCPY Processor 
Routine 

This routine processes VARY HARDCPY 
commands . 



• Entry : IEE4703D, from IEE3103D if com- 
mand has no keyword operands, IEE4203D 
if command has keyword operands. 

• Exit : To IEE4103D to issue a hardcopy 
message, IEE0503D or IEE2103D on 
errors . 

• Tables/Work Areas : XSA, UCM, M/S resi- 
dent data area, CVT and UCB. 

• Attributes : Reentrant, transient 



• Control Sections: IEE4703D 



IEE4803D: SVC 34 — VARY CONSOLE 



I nformation Message Routine 



This routine constructs a message which 
shows the current status of the varied 
console. 

• Entry : IEE4803D, from IEE4903D 

• Exit : To IEE4103D to issue the mes- 
sage, IEE0503D for errors 

• Tables/Work Areas : XSA, message area, 
UCB, CVT, and UCM 

• Attributes : Reentrant, transient 

• Control Sections : IEE4803D 

I EE4903D: SVC 34 — VARY CONSOLE Processor 
Routine 

This module processes the VARY CONSOLE 
command. 

• Entry : IEE4903D, from IEE4203D 

• Exit : To IEE4803D to construct console 
message, IEE4603D to dispatch error 
messages 

• Table/Work Areas : XSA, CVT, UCB, and 
UCM 

• Attributes : Reentrant, self- 
relocating, read-only, transient 

• Control Sections: IEE4903D 



I EFACTFK: Termination — User Dummy 
Accounting Routine 

This routine takes the place of the user's 
accounting routine when a user accounting 
routine was specified at system generation, 
but none was supplied. 

• Entry : IEFACTLK 

• Exit : Return to caller 

• Control Section : IEFACTLK 

I EFACTLK: Termination — User Accounting 
Routine Linkage Routine 

This routine provides linkage between the 
termination routine and the user's account- 
ing routine. It also sets up the required 
parameter list — including the execution 
time of the job step — and reads the first 
record of the account control table. 

• Entry : IEFACTLK 
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• Exits ; To user f s accounting routine, 
return to caller. 



• Tables/Work Areas ; 
JACT, SACT, QMPA 

• Control Section: 



LCT, JCT, SCT, 



IEFACTLK 



IEFACTRT: Termination — Dummy Accounting 
Routine 

This routine takes the place of the user- 
supplied accounting routine, 

• Entry ; IEFACTRT 

• Exit ; Return to caller 

• Control Section : IEFACTRT 

IEFAVFAK: I/C Device Allocation — Linkage 
to IEFXV001 

This routine passes control to the AVR rou- 
tine (IEFXV001) via and XCTL macro 
instruction. 

• Entry : IEFXV001 

• Exit : XCTL to IEFXV001 

• Control Section : IEFXV001 

IEFCVFAK: I/C Device Allocation — Linkage 
to IEFMCVOL 

This routine passes control to Mount 
Control-Volume Routine IEFMCVOL via an XCTL 
macro instruction to one of three entry 
points, IEFCVCL1, IEFCVOL2, or IEFCVOL3. 

• Entries : IEFCVOL1, IEFCVOL2, IEFCVOL3 

• Exits : XCTL to IEFCVOL1, IEFCVOL2, 
IEFCVCL3 

• Control Section : IEFCV0L1 

IEFDSDRP: Data Set Descriptor Record 
Processing Routine 

This routine processes the job queue infor- 
mation in the DSDR record to make a 
restarting job's queue entry reflect the 
environment when the checkpoint was taken. 

• Entry Point : IEFDSDRP 

• Exit : Return to caller 

• Table/Work Areas : JCT, SCT, SIOT, 
JFCB, TICT, UCB, CVT, VOLT, TCB, QMPA, 
CSCB, DCBD, DCB, JFCEX, SCTX, LCT 

• Attributes : Reenterable 

• Control Section: IEFDSDRP 



I EFIDMPM: Termination — Message Nodule 

This routine contains the messages used by 
the Indicative Dump routine. 

• Entry : IEFIDMPM 

• Attributes : Non-executable 

• Control Section: IEFIDMPM 



I EFLOCDQ: Queue Management — Degueue by 
Jobname Routine 

This routine searches a queue for a named 
job or list of named jobs, and can return 
information, or dequeue or cancel the job. 

• Entry : LOCDQ, LOCCAN, LCC 

• Exit : Return to caller 

• Tables/Work Areas : QCR, LTH 

• Attributes : Reenterable 

• External References : IEFCNVRT, 
IEFRDWRT 

• Page Reference : 71 

IEFMCVOL: I/O Device Allocation — Mount 
Control- Volume Routine 

This routine will have a control volume 
mounted when a data set called for in a job 
step cannot be located on any currently 
mounted control volume. 

• Entries : IEFCV0L1, IEFCVCL2 , IEFCV0L3 

• Exits: IEFVM1, IEFVMCVL, IEFVM6 , IEFYN 
(IEFK41SD) 

• Tables/Work Areas : LCT, JCT, SCT, 
SIOT, JFCB, VOLT, QMPA, UCB 

• Attributes : Reusable 

• Control Sections : IEFCVCL1, IEFCVCL2, 
IEFCVOL3 



I EFORMAT: Queue Management — Queue 
Formatting Routine 

This routine places the work queue data set 
in the format required by the MFT queue 
management routines. 

• Entry : IEFORMAT, from IEFSD055 

• Exit : Return to IEFSD055 

• Tables/work Areas : DCB, DEB 

• Attributes: Reusable 
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• Control Section : IEF0RMAT 

• Page Reference ; 49 



IEFQAGST: Queue Management — Assign/Start 
Routine 

This routine sets up an ECB/IOB and pre- 
pares the queue manager parameter area for 
the assign routine. 

• Entry : IEFQAGST 

• Exit : Return to caller 

• Tables/Work Areas : Q/M resident data 
area, QMPA, CVT 

• Attributes : Reenterable 

• Control Section : IEFQAGST 

• Page Reference : 55 



IEFQASGQ: Queue Management — Assign 
Routine 

This routine assigns records to a queue 
entry and assigns logical tracks as 
required. 

• Entry : IEFQASGN 

• Exit : Return to caller 

• Tables/Work Areas : Q/M resident data 
area, QMPA, CVT 

• Attributes : Reenterable 

• Control Sections : IEFQASGN, IEFQASNM 

• Page Reference : 55 



IEFQBVMS: Queue Management — Control 
Routine 

This routine inspects the function code in 
the queue manager parameter area and, on 
the basis of this code, branches to the 
appropriate queue management routines. 

• Entry : IEFQMSSS 

• Exits : To IEFQAGST, IEFQMRAW, 
IEFQMNQQ, or IEFQASGQ, return to caller 

• Tables/Work Areas : QMPA 

• Attributes : Reenterable 

• Control Section : IEFQMSSS 



I EFQDELQ: Queue Management — Delete 
R outine 

This routine makes those logical tracks 
assigned to a queue entry available for 
assignment to other queue entries. 

• Entry : IEFQDELE 

• Exit : Return to caller 

• Tables/Work Areas : ITH, QMPA, QCR, Q/M 
resident data area, CVT 

• Attributes : Reenterable 

• Control Section : IEFQDELE 

• Page Reference : 59 



IEFQMDQQ: Queue Management — Dequeue 
Routine 

This routine removes the highest priority 
entry from an input queue or a system out- 
put queue. 



• Entry : IEFQMDQ2 

• Exit : Return to caller 

• Tables/Work Areas : CVT, Q/M resident 
data area, QCR, LTH 

• Attributes : Reenterable 

• Control Section : IEFQMDQ2 

• Page Reference : 59 

IEFQMD13M: Queue Management — Dummy Module 

This routine prevents the occurrence of an 
unresolved external reference to module 
IEFQMSSS during system generation. 

• Entry : IEFQMDUM 

• Attributes : Non -Executable 

• Control Section : IEFQMSSS 



Branch 



I EFQMLK1: Queue Management 
Routine 



This routine branches to the appropriate 
gueue management routine on the basis of an 
assign or read/write function code issued 
by an initiator. 

• Entry : IEFQMSSS 

• Exits: To IEFQASGQ or IEFQMRAW 



Appendix B: MFT Modules 129 



• Tables/Work Areas : QMPA 

• Attributes : Reenterable 

• Control Section : IEFQMSSS 



opened DCB/DEB and the roaster queue control 
record at nucleus initialization time. 

• Attributes : Non-executable 

• Control Section: IEFJOB 



IEFQMNQQ: Queue Management — Enqueue 
Routine 

This routine places an entry in an input 
queue or an output queue at the requested 
priority . 

• Entry : IEFQMNQ2 

• Exit ; Return to caller 

• Tables/Work Areas : CVT f Q/M resident 
data area, QMPA, QCR, LTH 

• Attributes : Reenterable 

• Control Section : IEFQMNQ2 



IEFQMRAW: Queue Management — Read/Write 
Routine 

This routine performs the conversion of a 
TTR into a MBBCCHHR and reads or writes up 
to 15 records of the work queue data set. 

• Entry : IEFQMRAW 

• Exit : Return to caller 

• Tables/Work Areas : Q/M resident data 
area, QMPA, CVT, IOB/ECB 

• Attributes: Reenterable 



• Control Section : IEFQMRAW 



IEFQMUNQ: Queue Management — Unchain 
Routine 

This routine removes a task from the queue 
management no-work chain. 

• Entry : IEFQMUNC 

• Exit : Return to caller 

• Tables/Work Areas : CVT, Q/M resident 
data area, QCR 

• Attributes : Reenterable 

• Control Section : IEFQMUNC 



IEFQRESD: Queue Management — Resident 
Main Storage Reservation Module 

This routine reserves 140 bytes of resident 
main storage for the queue-management- 



IEFRCLN1: Restart Reader Linkage 



This routine receives control from IEFVRRC 
and LINKS to interpreter initialization 
routine IEFVH1. 

• Entry : IEFRCLN1 

• Exit : XCTL to IEFVRRC at entry 
IEFVRRCA 

• Attributes : Reenterable 

• Control Section : IEFRCLN1 

IEFRCLN2: Restart Reader Linkage 



This routine receives control from IEFVRRC 
and LINKS to interpreter initialization 
routine IEFVH1. 

• Entry : IEFRCLN2 

• Exit: XCTL to IEFVRRC at entry 
IEFVRRCB 

• Attributes : Reenterable 

• Control Section : IEFRCLN2 
IEFRPREP: Termination — Restart 



Preparation Routing 



This routine determines whether a job step 
that has been abnormally terminated can be 
restarted. 

• Entry : IEFRPREP from IEFYNIMP 

• Exit : Return to caller 

• Attributes : Reenterable 

• Tables/ Work Areas : LCT, JCT, SCT, PDQ, 
QMPA 

• Control Section: IEFRPREP 



IEFRSTRT: Restart SVC Issuing Routine 

This routine issues the Restart SVC. When 
called by its alias, IEFSMR, it issues the 
Restart SVC and then returns to the caller. 



• Entry : IEFRSTRT, IEFSMR 
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• Exit : SVC 52 (RESTART) , return to 
caller 

• Attributes ; Reenterable 

• Control Sections ; IEFRSTRT 

IEFSD017: Termination — System Output 
Interface Routine 

This routine provides an interface between 
the termination entry routine and system 
output processing. 

• Entry ; IEFSD017 

• Exit : To IEFSDU2Q 

• Control Section : IEFSD017 

IEFSD055: Queue Management — Queue 
Initialization Routine 

This routine constructs a resident DEB/DCB, 
passes control to the queue formatting rou- 
tine or the first phase of system restart, 
initializes the queue manager resident data 
area, and (if required) passes control to 
the second phase of the system restart 
routine. 

• Entry : IEFSD055 f from IEFQINTZ 

• Exits : To IEFORMAT, IEF300SD, or 
IEF304SD 

• Attributes : Reusable 

• Control Section : IEFSD055 

• Page Reference : 54 

IEFSD070: System Output Writer — Data Set 
Writer Interface Routine 

This routine passes control to the standard 
data set writer or to the user-supplied 
data set writer routine. 



Entry ; 



IEFSD070 



• Exits : To IEFSD087 or user-supplied 
routine via LINK, or to IEFSD171 via 
XCTL 

• Attributes : Reenterable 

• Control Section : IEFSD070 

• Page Reference : 72 

IEFSD078: System Output Writer — Linker 
Routine 

This routine determines whether the record 
obtained from the output queue entry is a 
DSB or SMB, and passes control, according- 
ly, to the DSB or SMB processor. 



• Entry : IEFSD078 

• Exits: To IEFSD085, IEFSD086, or 
IEFSD079 

• Attributes : Reenterable 

• Control Section: IEFSD078 



I EFSD079: System Output Writer — Link to 
Queue Manager Delete Routine 

This routine passes control to the delete 
routine to delete the current output queue 
entry. 

• Entry : IEFSD079 

• Exits : To IEFQDELQ and IEFSD082 

• Tables/Work Areas : QMPA 

• Attributes : Reenterable 

• Control Section : IEFSD079 

• Page Reference : 79 



IEFSD080: System Output Writer — 
Initialization Routine 



This routine initializes the system output 
writer by obtaining main storage for a pa- 
rameter list and the output DCB, and open- 
ing the output DCB. 

• Entry : IEFSD080 

• Exit : To IEFSD081 

• Tables/Work Areas : DCB, CSCB, TIOT, 
JFCB 

• Attributes: Reenterable 

• Control Section : IEFSD080 

IEFSD081: System Output Writer — Class 
Name Setup Routine 

This routine obtains main storage for, and 
initializes, a list of ECB pointers, ECBs, 
and queue management communication ele- 
ments, depending on the system output 
classes specified for the writer. 

• Entry : IEFSD081 

• Exit : To IEFSD082 

• Tables/Work Areas : CSCB, ECB 

• Attributes : Reenterable 

• Control Section: IEFSD081 
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IEFSDQ82: System Output Writer — Main 
Logic Routine 

This routine obtains main storage for QMPAs 
and internal work areas, dequeues output 
queue entries, checks for operator com- 
mands, and passes control to the appropri- 
ate routine. 

• Entry ; IEFSD082 

• Exits : IEFSD083, IEFSD084, IEFSD078 

• Tables/Work Areas : CSCB, ECB 

• Attributes : Reenterable 

• Control Section: IEFSD082 



IEFSD083: System Output Writer — Command 
Processing Routine 

This routine processes MODIFY and STOP com- 
mands that apply to the writer. 

• Entry : IEFSD083 

• Exits : To IEFSD081 or IEEVTCTL 

• Tables/Work Areas : CSCB, DCB, QMPA, 
ECB 

• Attributes : Reenterable 

• Control Sections : IEFSD083, IEFSD83M 



IEFSD084: System Output Writer — Wait 
Routine 

This routine waits for an entry to be 
enqueued in an output queue corresponding 
to a class available to the writer. 

• Entry : IEFSD084 

• Exit : To IEFSD082 

• Attributes : Reenterable 

• Control Section : IEFSD084 

• Page Reference : 72 

IEFSDQ85: System Output Writer — DSB 
Handler Routine 

This routine initializes for data set pro- 
cessing, and informs the operator of the 
pause option in effect. 

• Entry : IEFSD085, IEF085SD, or IEF850SD 

• Exit: To IEFSD171 

• Attributes: Reenterable 



• Control Sections : IEFSD085, IEFSD85M 

• Page Reference : 73 



IEFSD086: System output Writer — SMB 
Handler 

This routine initializes for message pro- 
cessing, and extracts each message from the 
current SMB. 

• Entry : IEFSD086, IEF086SD 

• Exits : To IEFSD088, IEFSD089, 
IEFQMNQQ, IEFQMRAW, IEFSD085, IEFSD078 

• Tables/ Work Areas : SMB, UCB, QMPA, 
TIOT, CSCB, TCB 

• Attributes : Reenterable 

• Control Sections : IEFSD086, IEFSD86M 

IEFSD087: System Output Writer — Standard 
Writer Routine 

This routine gets records from a data set. 

• Entry : IEFSD087 

• Exits : To IEFSD088, IEFSD089, IEFSD078 

• Tables/Work Areas : DCB 

• Attributes : Reenterable 

• Control Sections : IEFSD087, IEFSD87M 

• Page Reference : 73 

IEFSD088: System Output Writer — 
Transition Routine 

This routine handles the transition between 
messages and data sets, and between data 
sets. 

• Entry : IEFSD088 

• Exit : To IEFSD089 

• Tables/work Areas : DCB 

• Attributes : Reenterable 

• Control Section : IEFSD088 

IEFSD089: System Output Writer — Put 
Routine 

This routine formats records as required 
and issues PUT macro instructions to write 
them on the output unit. 

• Entry : IEFSD089 

• Exit: To IEFSD088 
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• Tables/Work Areas : DCB 

• Attributes : Reenterable 

• Control Sections : IEFSD089, IEFSD89M 

IEFSD094: System Output Writer — Job 
Separator Routine 

This routine prints or punches a job name 
and system output class designation on the 
writer 1 s output device. 

• Entry : IEFSD094 

• Exits : To IEFSD088, IEFSD089, 
IEFSD095, IEFSD078 

• Attributes : Reenterable 

• Control Section : IEFSD094 



IEFSD095: System Output Writer — Print 
Line Routine 

This routine constructs the block, letters 
used to separate jobs processed by a system 
output writer when the output data set is 
to be printed. 

• Entry : IEFSD095 

• Exit : Return to caller 

• Attributes : Reenterable 

• Control Section: IEFSD095 



IEFSD096: System Output Writer — Message 
Module 

This routine contains message headers and 
texts for messages to the operator. 

• Entry : IEFSD096 

• Attributes : Non- executable 

• Control Section: IEFSD096 



IEFSD097: I/O Device Allocation — Wait 
for Space Decision Routine 

This routine makes the decision whether to 
wait for direct access space, and provides 
an interface with the I/O device allocation 
space request routine so that retry and 
additional recovery passes may be made. 

• Entry : IEFSD097 

• Exit : Branch on register 14 

• Tables/Work Areas : LCT, TIOT, UCB 



• Attributes : Read-only, reenterable 

• Control Section : IEFSD097 

IEFSD168: Initiator — Job Suspension 



This routine causes a terminated job to be 
reenqueued so that the job can be 
reactivated. 

• Entry : IEFSD068 

• Exit : Branch to IEFSD598 to purge 
resources, branch to IEFSD510 to rein- 
itiate job 

• Tables/Work Areas : QMPA, LCT, JCT, 
SCD, SCT 

• Attributes : Reenterable 

• Control Section : IEFSD068 

• External Reference : IEFQMRAW, 
IEFQMNQ2, IEFVSDRA 



IEFSD171: System Output Writer — Data Set 
Delete Routine 

This routine obtains records from an output 
queue entry, and deletes system output data 
sets. 

• Entry : IEFSD071 

• Exits : To IEEVLOUT, IEFQMNQ2 , 
IEF850SD, IEF086SD, IEFSD078, or 
IEFQMRAW 

• Tables/Work Areas : DCB, SMB, UCB, CVT, 
QMPA, TIOT, CSCB, TCB 

• Attributes : Reenterable 

• Control Sections : IEFSD071, IEFSD71M 

IEFSD195: I/O Device Allocation — Wait 
for Deallocation Routine 

This routine provides the I/O device allo- 
cation routine with the ability to wait for 
deallocation to occur during the execution 
of another task, when allocation cannot be 
completed because of current allocations. 

• Entry : IEFVAWAT 

• Exit : Return to caller 

• Tables/Work Areas : JCT, SCT, SICT, 
LCT, ECG, CSCB 

• Attributes : Read-only, reenterable 

• Control Section: IEFSD095 



Appendix B: MFT Modules 133 



IEFSD21Q; I/C Device Allocation — 
Allocation Entry Routine 

This routine provides an interface for 
entry to the I/O device allocation routine 
operating in a multiprogramming environ- 
ment. 

• Entry : IEFW21SD 

• Exits : To IEFVK, IEFVM or IEFWD000 

• Tahles/Work Areas ; JCT, LCT, SCT, SMB, 
QMPA, CVT 

• Attributes : Read-only, reenterable 

• Control Section: IEFWLISD 



determines the type of entry, and con- 
structs the purge queue. 

• Entry : IEFSD301 

• Exit : To IEFSD302 

• Tables/Work Areas : System restart work 
area. Table A, Table C purge queue, 
interpreter jobnames table 

• Attributes : Reenterable 

• Control Section: IEFSD301 



IEFSD302: 
Routine 



System Restart — Jobnames Table 



IEFSD22Q: Termination Routine — Step 
Terminate Exit Routine 

This routine provides an interface between 
the termination routine and the step delete 
or alternate step delete routine when a 
step has been terminated. 

• Entry : IEFW22SD 

• Exit : Return to caller of termination 
routine 

• Tables/Work Areas : JCT, SCT f SMB, LCT, 
QMPA, ECB 

• Attributes : Read-only, reenterable 

• Control Section : IEFW22SD 

• Page Reference : 71 

IEFSD30Q: System Restart — Initialization 
Routine 

This routine reads all QCRs and logical 
track header records into main storage, 
builds tables A, B, and C, and removes from 
Table A all the LTH entries corresponding 
to logical tracks in the free-track queue 
or in one of the other queues. 

• Entry : IEFSD300 

• Exit : To IEFSD301 

• Tables/Work Areas : System restart work 
area. Table A, Table E, Table C 

• Attributes : Reenterable 

• Control Section : IEFSD300 

IEFSD3 01: System Restart — Purge Queue 
Construction Routine 

This routine searches Table A for the last 
LTH corresponding to each queue entry. 



This routine removes from Table A all log- 
ical tracks assigned to dequeued input or 
RJE queue entries, and builds a table of 
jobnames for incomplete input and RJE queue 
entries and dequeued input queue entries. 

• Entry: IEFSD3 02 

• Exit: To IEFSD303 

• Tables/Work Areas : System restart work 
area. Table A, Table C, and the 
interpreter /initiator jobnames table 

• Attributes : Reenterable 

• Control Section : IEFSD302 

IEFSD303: System Restart — Delete Routine 

This routine creates a queue entry of the 
remaining logical tracks and deletes that 
entry, thus assigning those tracks to the 
free-track queue. 

• Entry : IEFSD3 03 

• Exit : Return to caller 

• Tables/ Work Areas : System restart work 
area, QMPA, Table A 

• Attributes : Reenterable 

• Control Section : IEFSD303 

I EFSD304: System Restart — Scratch Data 
S ets Routine 

This routine informs the operator of the 
names of jobs being processed by an inter- 
preter, and scratches temporary data sets 
generated for incomplete input queue 
entries. 

• Entry: IEFSD3 04 

• Exits : To IEFSD055, IEFSD308 
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• Tables/Work Areas ; CVT, UCB address 
look-up table 

• Attributes : Reenterable 

• Control Section: IEFSD304 



I EFSD310: System Restart — TTR and KN to 
M BBCCHHR Conversion Routine 

This routine converts a relative record 
address (NN) or a relative track and record 
address (TTR) to an actual disk address 
(MBBCCHHR) . 



IEFSD305: System Restart — Reenqueue 
Routine 

This routine dequeues the entries in the 
purge queue and reenqueues them in the 
appropriate input or output queue and 
informs the operator of the names of jobs 
in the process of initiation. 

• Entry : IEFSD305 

• Exit : IEFSD304 

• Tables/Work Areas : System restart work 
area, purge queue, JCT, SCT, JFCE, DSB, 
SCD, SIOT. 

• Attributes : Reenterable 

• Control Section: IEFSD305 



• Entry: IEFSD310 

• Exit : Return to caller 

• Tables/Work Areas : CVT 

• Attributes : Reenterable 

• Control Section : IEFSD310 

I EFSD311: Queue Management — Message 
Module 

This routine contains the messages required 
by the queue initialization routine 
(IEFSD055). 

• Entry : IEFSD311, SD55MSGl f SD55MSG2 , 
SD55MSG3 

• Attributes: Non- executable 



IEFSD308: System Restart — Scratch Data 
Sets Routine 

This routine scratches the temporary data 
sets generated for incomplete input gueue 
entries. 

• Entry : IEFSD308 

• Exit : Return to caller 

• Tables/Work Areas : DSCE, BCB, UCB f 
CVT, VTCC, DEE 

• Attributes : Reenterable 

• Control Section : IEFSD308 

IEFSD31Q: Termination Routine — Job 
Termination Exit Routine 

This routine provides an interface between 
the termination routine and the step delete 
or alternate step delete routine when the 
last step of a job has been terminated. 

• Entry : IEFW31SD 

• Exit : Return to caller of termination 
routine 

• Tables/Work Areas : JCT, SCT, SMB, 
QMPA, ECB, CVT, M/S resident data area 

• Attributes : Read-only, reenterable 

• Control Section: IEFW31SD 



• Control Section : IEFSD311 

I EFSD312: System Restart — Message Module 

This routine contains the messages reguired 
by the system restart routines. 

• Entry : IEFSD312, SD304MG1, SD304MG2, 
SD305MG1 

• Attributes : Non-executable 

• Control Section : IEFSD312 

IEFSD41Q: I/O Device Allocation — 
Allocation Exit Routine 

This routine provides an interface for exit 
from the I/O device allocation routine 
operating in a multiprogramming environ- 
ment. 

• Entry : IEFW41SD, IEFW1FAK, IEFW2FAK 

• Exits : To IEFVM, or return to caller 

• Tables/ Work Areas : JCT, LCT, SCT, SMB, 
QMPA 

• Attributes : Read-only, reenterable 

• Control Section: IEFW41SD 



IEFSD42Q: 



Termination Routine — 



Termination Entry Routine 

This routine provides an interface for 
entry to the termination routine operating 
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in a multiprogramming environment, it also 
provides an interface for entry to the LOG 
function if a LOG data set is scheduled to 
be added to the SYS0UT queue - 



• Entry : IEFW42SD 

• Exit : To IEFYN 

• Tables/Work Areas : JCT, SCT, SMB, LCT, 
TI0T 

• Attributes : Read-only , reenterable 

• Control Section: IEFW42SD 



IEFSD510: 



Initiator — Job Selection 



Routine 

This routine selects a system or problem 
program job. This module executes only in 
a large (scheduler-size) partition. 



• Entry : IEFSD510 



Exits : Branch to IEFSB511 or IEFSD515 f 
LINK to IEFSD519, XCTL to IEFSE589 f 
SMALTERM, or IEEVSTAR 



• Tables/Work Areas : LOT block, CSCB, 
SPIL, CVT, TCB, PIB 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD510 

• External References : IEFQMDQQ, 
IEFQiysUNC 

• Page Reference : 63 

IEFSD511: Initiator — Job Initiation 
Routine 

This routine initializes information per- 
taining to a job. 

• Entry : IEFSD511 

• Exit : Branch to IEFSD541 

• Tables/Work Areas : Life-of-Task Block, 
CSCB, JCT, SCT, SCD, PIB, IOB2 

• Attributes : Read-only, Reenterable 

• Control Section : IEFSD511 

• External References : IEFQMRAW 

• Page Reference : 68 



I EFSD512: Initiator — Step Initiation 
R outine 

This routine passes control to allocation 
as a closed subroutine via a LINK macro 
instruction. If an allocation error 
occurs, it passes control to the Alternate 
Step Deletion routine. Otherwise, it con- 
tinues normally and schedules a job step. 

• Entry : IEFSD512 

• Exits : Branch to IEFSD513 , IEFSD516, 
or IEFSD518, XCTL to IEFSD510 

• Tables/Work Areas : LOT Block, JCT, 
SCT, APL, HOT, CSCB, I0B1, ICB2 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD512 

• External References : IEFQMRAW, 
IEFSD556, IEFSD514 

• Page Reference : 68 



IEFSD513: Initiator — Problem Program 
Interface 

This routine prepares the partition for 
problem program execution by moving the 
HOT to the highest available storage area. 

The routine also opens JOBLIB and FETCH 
DCBs, if reguired. A final check is made 
to determine if a CANCEL command has been 
received for the job before the problem 
program is brought into the partition and 
given control. If scheduling was performed 
for a small partition, IEFSD513 communi- 
cates with the small partition. 

• Entry : IEFSD513 

• Exits : XCTL to problem program, ABEND, 
or to IEFSD510 

• Tables/Work Areas : LOT Block, Transfer 
Parameter List, TICT, User's Parameter 
List, TCB, CVT, PIB, CSCB, SPIL, APL, 
JCT, SCT, DCB 

• Attributes : Read-only, reenterable 

• Control Section: IEFSD513 



• Page Reference : 
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IEFSD514: Queue Management — Table 
Breakup Routine 

This routine reads and writes tables which 
may be reguired by the job scheduler. The 
routine breaks the tables into 176 -byte 
records, writes the records on disk, and 
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retrieves the records from disk to recon- 
struct the tables in main storage. 

• Entry : IEFSD514 

• Exit : Return to caller 

• Tables/Work Areas ; QMPA, TBR Parameter 
List 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD514 

• External References : IEFQASGN, 
IEFQMRAW 

• Page Reference : 59 



IEFSD515; 
Routine 



Initiator — Step Deletion 



This routine retrieves the TIOT and Life- 
of-Task Elock from disk, reads in the JCT 
and SCT, and branches to termination, which 
is used as a closed subroutine. It also 
reads in the SCT for the next step to be 
scheduled, if required. 

• Entry : IEFSD515, SMALTERM, or GO 

• Exits : XCTL to IEFSD512 or Branch to 
IEFSD517 or IEFSD510 

• Tables/Work Areas : Life-of-Task Block, 
Terminate Parameter List, CVT, TCB, 
PIB, ICB, CSCB, DCB, JCT, SCT, SPIL 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD515 

• External References : IEFQMRAW, 
IEFSD514, IEFSD42Q, IEFSD598 

• Page Reference : 70 



IEFSD516: Initiator — Alternate Step 
Deletion Routine 

This routine provides an interface with 
termination when an allocation error occurs 
during step initiation. Termination is 
used as a closed subroutine. If required, 
this routine reads the SCT of the next step 
to support job flushing. 

• Entry : IEFSD516 

• Exits : Branch to IEFSD512 or IEFSD517 

• Tables/Work Areas : Life-of-Task block, 
CSCB, Terminate Parameter List, SCT 

• Attributes : Read-only, reenterable 



• Control Section : IEFSD516 

• External References : IEFQMRAW, 
IEFSD42Q 

• Page Reference : 71 

I EFSD517: Initiator — Job Deletion 
Routine 

This routine deletes the disk queue entry 
f cr a terminated job and unchains and 
deletes the CSCB for the job. 

• Entry : IEFSD517 

• Exit : Branch to IEFSD510 

• Tables/Work Areas : CSCB, Life-of-Task 
block, SPIL 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD517 

• External References : IEFQDELE, 
IEFSD598 

• Page Reference : 71 

IEFSD518: Initiator — Partition Recovery 
R outine 

This routine determines the status of main 
storage required for a checkpoint/restart. 

• Entry : IEFSD518 

• Exits : Return to IEFSD512 

• Tables/ Work Areas : SPIL, CVT, TCB, 
JCT, PIB, LOT, QMPA, CSCB 

• Attributes : Reenterable 

• Control Section : IEFSD518 

• External Reference : IEFQMRAW, 
IEFQMNQ2, IEFSD598 

• Page Reference : 71 

I EFSD519: Queue Management — Dequeue by 
Jobnam e Interf ac e Routin e 

This routine builds a seven -word parameter 
list used by IEFLOCDQ to locate a job by 
jobname on the checkpoint/restart internal 
queue. 

• Entry : IEFSD519 

• Exit : Return to IEFSD510 

• Tables/Work Areas : LOT, PIB 
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• Attributes : Reenterable 

• Control Section : IEFSD519 

• External Reference : IEFLOCDQ, lEFQMRAW 

• Page Reference : 71 

IEFSD530: Interpreter — Transient Reader 
Suspend Routine 

This routine closes the reader input data 
set and procedure library, and saves data 
required to restore the reader. 

• Entry : IEFSD530 

• Exit : Return to caller 

• Tables/Work Areas : IWA, TIOT, LWA, 
QMPA, CVT, UCB, MSRC, PIE, CSCB 

® Attributes : Read-only, reenterable 

• Control Section : IEFSD530 

• External References : IEFSD514, IEF- 
QMRAW, IEFQASNM, IEFQASGN 

• Page Reference : 62 



IEFSD531: Interpreter — Transient Reader 
Restore Routine 

This routine restores the information 
required to "restart" a transient reader 
after it has been suspended. It reopens 
the reader input data set and procedure 
library. 

• Entry : IEFSD531 

• Exit : XCTL to IEFVHCE 

• Tables/Work Areas : IWA, TIOT, QMPA, 
CVT, UCB, MSRC, PIB, CSCB 

• Attributes : Read-only, reenterable 

• Control Sections : IEFSD531, IEFPH2 

• External References : IEFSD514, IEF- 
QMRAW, IEFQASNM, IEFQASGN 

• Page Reference : 62 



IEFSD532: Interpreter — Transient Reader 
Suspend Tests 

This routine determines the status of a 
transient reader. IEFSD532 receives con- 
trol from IEFVHH after a job has been 
enqueued. 



1 



Entry : 



IEFKG 



• Exits: XCTL to IEFVHN or IEFSD530, or 
branch to IEFVHHB 

• Tabl es/Work Areas : IWA, LWA, QMPA, 
PIB, CVT 

• Attributes : Read-only, reenterable 

• Control Section : IEFKG 

• Page Reference : 62 

I EFSD533: Interpreter — Interface Routine 

This routine provides an interface between 
the reader /interpreter and system task 
control. 

• Entry : IEFIRC 

• Exits: XCTL to IEFSD537. RETURN to 
STC if error. 

• Tables/ Work Areas : CSCB, CVT,, QMPA 

• Attributes : Reenterable, read-only 

I • Control Section : IEFIRC 

IEFSD534: System Task Control — IPSW 
Routine 

This routine places system task control in 
problem program mode by loading a PSW. 

• Entry : IEFSD534 

• Exit : IEFVSTRT 

• Tables/Work Areas : None 

• Attributes : Reenterable 

• Control Section : IEFSD534 

I EFSD535: System Task Control — Problem 
Program Mode Routine 

This routine puts system task control in 
problem program mode for ABEND. 

• Entry : IEFSD535 

• Exit : IEEVTCTL 

• Tables/Work Areas : None 

• Attributes : Reenterable 

• Control Section: IEFSD535 



I EFSD536: Interpreter — Operator Message 
R outine 

This routine writes a message to the opera- 
tor when an I/O error or CPO full condition 



138 



has occurred. The routine also sets proper 
indicators to cause a cleanup of the cur- 
rent job. 

• Entry ; IEFVHR 

• Exits : Return to caller, XCTL to 
IEFVHN, or LINK to IEFSD30 8 

• Tables/Work Areas ; IWA, JCT, LWA, UCB, 
CVT f PIE, CSCB, Master Scheduler resi- 
dent data area 

• Attributes : Read-only , reenterable 

• Control Section : IEFVHR 

• Fage Reference : 61 



IEFSD537: Interpreter — Linkage Module 

This routine provides an interface between 
system task control and a reader. It also 
frees the interpreter entrance list (NED 
and associated areas if a reader is being 
terminated or suspended. 

• Entry : IEFSD537 

• Exits : LINK to IEFVH1, or IEFSD531, or 
Return to system task control 

• Tables/Work Areas : NEL 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD537 

IEFSD540: Initiator — Linkage to IEFSD541 

This routine provides an interface linkage 
to IEFSD5U1 via an XCTL macro instruction. 

• Entry : IEFSD540 

• Exit : XCTL to IEFSD541 

• Tables/Work Areas : Same as caller 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD540 

IEFSD5U1: Initiator — Data Set Integrity 

This routine enqueues on explicit data sets 
and thus prevents concurrent, and impair- 
ing, access between tasks . 

• Entry : IEFSD541 

• Exit : Branch to IEFSD512 

• Tables/Work Areas : LOT Elock, IOBl f 
I0B2, JCT, SCT, CSCB, SPIL, DSENQ 
Table, Minor Name List, ENQ supervisor 
list. 



• Attributes : Read-only 

• Control Section : IEFSD541 

• External References : IEFQMRAW 

• Page Reference : 68 



I EFSD551: I/O Device Allocation — linkage 
t o IEFXJIMP 

This routine provides an interface linkage 
to IEFXJIMP via an XCTL macro instruction 
in the 3 OK design package. 

• Entry : IEFV15XL 

• Exit: XCTL to IEFXJIMP 

• Tables/Work Areas : Same as caller 

• Attributes : Read-only, reenterable 

• Control Section : IEEV15XL 

IEFSD552: I/O Device Allocation — Linkage 
t o IEFXJIMP 

This routine provides an interface linkage 
to IEFXJIMP via an XCTL macro instruction 
in the 3 OK design package. 

• Entry : IEFXJX5A 

• Exit : XCTL to IEFXJIMP 

• Tables/Work Areas : Same as caller 

• Attributes : Read-only, reenterable 

• Control Section : IEFXJX5A 

IEFSD553: Initiator — Linkage to IEFSD512 

This routine provides a linkage to IEFSD512 
via an XCTL macro instruction. 

• Entry : IEFSD512 

• Exit : XCTL to IEFSD512 

• Tables/Work Areas : Same as caller 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD512 

I EFSD554: Initiator -- Linkage to IEFSD516 

This routine provides a linkage to IEFSD516 
via an XCTL macro instruction. 

• Entry : IEFSD554 

• Exit : XCTL to IEFSD516 

• Tables/ Work Areas: Same as caller 
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• Attributes ; Bead-only , reenterable 

• Control Section : IEFSD554 

IEFSD555; Initiator — Linkage to IEFSD510 

This routine provides linkage to IEFSD510 
via an XCTL macro instruction. 

• Entry ; IEFSD555 

• Exit ; XCTL to IEFSD510 

• Tables/Work Areas : Same as caller. 

• Attributes : Read-only, reenterable 

• Control Section: IEFSD555 



IEFSD556: Initiator — Set Problem Program 
State Return 

This routine establishes the allocation 
routine in a problem program state, upon 
entry. 

• Entry : IEFSD556 

• Exit : LPSW to IEFW21SD 

• Tables/Work Areas ; Same as caller. 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD556 

IEFSD557: I/C Device Allocation — 
Interface Routine 

This routine provides an interface between 
system task control and allocation. 

• Entry : IEFW21SD 
© Exit : IEFWSD21 

• Tables/Work Areas : ECE f IOB 

• Attributes : Reenterable 

• Control Section : IEFSD557 

IEFSD558: Initiator — Linkage to IEFSD511 

This routine provides a linkage to IEFSD511 
via an XCTL macro instruction. 

• Entry : IEFSD558 

• Exit : IEFSD511 

• Attributes : Read-only, reenterable 

• Control Section: IEFSD558 



I EFSD559: Initiator — Linkage to IEFSD515 

This routine provides a linkage to IEFSD515 
via an XCTL macro instruction. 

• Entry : SMALTERM 

• Exit : IEFSD515 

• Attributes : Read-only, reenterable 

• Control Section: IEFSD559 



IEFSD567: Nucleus — Device-End Interrupt 
Handler Routine 

This routine handles unsolicited device-end 
interrupts from a disk storage unit. 

• Entry : IEFSD567 

• Exit : Return to caller 

• Tables /Work Areas : None 

• Attributes : Reenterable 

• Control Section : IEFSD567 

• External Reference : Communications 
Task TCB 

I EFSD569: Master Scheduler — 
Initialization Routine 

This routine initializes the communications 
task and the system log. It issues the 
READY message and formats the job queue, as 
well as typing out the automatic commands 
and invoking processing of the automatic 
commands. This routine establishes parti- 
tioning of main storage at system initiali- 
zation and readies the partitions for the 
START command. This routine is called out 
at system generation by the macro, 
SGIEEOVV. 

• Entry : IEFSD569 

• Exit : IEE0503D, Branch to dispatcher 

• Attributes : Read-only, non-reenterable 

• Control Section : IEFSD569 

• Page Reference : 48 

IEFSD572: Queue Management — Interpreter/ 
Queue Manager Interlock Routine 

This routine determines if a possible 
interlock condition exists between the 
queue manager and the reader. The routine 
issues a message requesting the operator to 
reply with either WAIT, to wait for space 
to be freed, or CANCEL, to cancel the job. 
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• Entry : IEFSD572 

• Exits : ABEND, or return to caller 

• Attributes : Read-only , reenterable 

• Control Section : IEFSD572, IEFSD573 

• External Reference : IEFQDELQ 

• Page Reference : 57 

IEFSD587: System Task Control — Linkage 
to IEFSD535 

This routine provides a linkage to IEFSD535 
via a LINK macro instruction. 

• Entry : IEFSD587 

• Exit : IEFSD535 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD587 

IEFSD588: System Task Control — Linkage 
to IEE53USD 

This routine links to IEE53USD to bring the 
suspended reader into the assigned parti- 
tion so that upon return, the initiator 
will be in supervisor state. 

• Entry: IEFSD588 

• Exit : LINK to IEE534SD 

• Tables/Work Areas : Same as caller 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD588 

IEFSD589: Initiator — Linkage to IEESD534 

This routine links to system task control 
so that upon return, the initiator will be 
in supervisor state. 

• Entry : IEFSD589 

• Exit : LINK to IEFSD534 

• Tables/Work Areas : Same as caller 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD589 

IEFSD597: Initiator — Shared DASD ENQ/DEQ 
Purge Routine 

This routine is the purge routine for sys- 
tems that include the shared DASD feature. 
In addition to purging all resources 
engueued by a job step, but not degueued, 
IEFSD597 also releases reserved devices. 



• Entry : IEFSD597 

• Exit: Return to caller 

• Tables/Work Areas : Major QCB, Minor 
QCB, QEL, TCB, SVRB, CVT, ABTERM 

• Attributes : Read-only, reenterable, 
disabled 

• Control Section : IEFSD597 

I EFSD598: Initiator — ENQ/DEQ Purge 
Routine 

This routine purges all resources engueued 
by a job step, but not degueued. 

• Entry : IEFSD598 

• Exit : Return to caller 

• Tables/ Work Areas : Major QCB, Minor 
QCB, QEL,, TCB, SVRB, CVT, ABTERM 

• Attributes : Read-only, Reenterable, 
disabled 

• Control Section : IEFSD598 

• Page Reference : 70 

I EFSD599: Initiator — Small Partition 
Module 

This routine provides an interface with the 
scheduler in a large partition to initiate 
and terminate small partitions. 

• Entry : IEFSD599,SMALLGC 

• Exits : ABEND, or XCTL to problem pro- 
gram or writer 

• Tables/Work Areas : SPII, allocate pa- 
rameter 1 ist (API) 

• Attributes : Read-only, reenterable 

• Control Section : IEFSD599 

• External Reference : IEFQMUNC 

• Page Reference : 66 

IEFVDA: Interpreter — DP Statement 
Processor 

This routine constructs and adds entries to 
a JFCB and SIOT from the complete logical 
DD statement in the internal text buffer. 

• Entry : IEFVDA 

• Exit : To IEFVHF 

• Tables/Work Areas : IWA, LWA, SIOT, 
JFCB, JCB, SCT 
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• Attributes : Read-only, reenterable 

• Control Section ; IEFVDA 

IEFVDBSD: Interpreter — Data Set Name 
Table Construction Routine 

This routine creates a data set name table. 

• Entry : IEFVDBSD 

• Exit ; To IEFVDA 

• Attributes : Reenterable 

• Control Section: IEFVDBSD 



IEFVEA: Interpreter — EXEC Statement 
Processor 

This routine constructs or updates an SCT, 
and f if necessary, a joblib JFCB and SIOT 
from the complete logical EXEC statement in 
the internal text buffer. 

• Entry : IEFVEA f from IEFVFA 

• Exit : To IEFVHF 

• Tables/Work Areas : IWA, EXEC work 
area, interpreter key table, JCT, SCT, 
SIOT, QMPA, procedure override table. 

• Attributes : Read-only, reenterable 

• Control Section : IEFVEA 

IEFVFA: Interpreter — Scan Routine 

This routine scans the card image of a JOB, 
EXEC, or DD statement, performs error 
checking of JCL syntax, builds internal 
text, and, when a complete logical state- 
ment (including continuations and over- 
rides) has been scanned, passes control to 
the appropriate statement processor. 

• Entry : IEFVFA 

• Exits : To IEFVGM, IEFVHQ, IEFVHF, IEF- 
VJA, IEFVDA, IEFVEA 

• Tables/Work Areas : IWA, scan routine 
work area, interpreter key table, QMPA, 
internal text buffer, scan dictionary. 

• Attributes : Read-only, reenterable 

• Control Section : IEFVFA 

IEFVFB: Interpreter — Symbolic Parameter 
Processing Routine 

This routine processes symbolic parameters 
by creating symbolic parameter table buffer 
entries to assign values to symbolic param- 
eters, and extracts those values and places 



them in the intermediate text buffer when a 
symbolic parameter is used. 

• Entry : IEFVFB 

• Exit : Return to caller 

• Tables/Work Areas : IWA, LWA SYMBUF, 
Intermediate Text Buffer, QMPA 

• Attributes : Read-only, reenterable 

• Control Section: IEFVFB 



I EFVGI: Interpreter — Dictionary Entry 
Routine 

This routine constructs entries for the 
refer-back dictionary. 

• Entry : IEFVGI 

• Exit : Return to caller 

• Tables/ Work Areas : Refer-back dic- 
tionary, auxiliary work area, IWA, QMPA 

• Control Section : IEFVGI 

I EFVGK: Interpreter — Get Parameter 
R outine 

This routine searches the internal text 
buffer for the next parameter, performs 
basic error checking, and passes control to 
the appropriate keyword routine. 

• Entry : IEFVGK 

• Exit : Return to caller 

• Tables/Work Areas : Local work area, 
IWA, internal text buffer, KBT, PDT. 

• Control Section : IEFVGK 

I EFVGM; Interpreter — Message Processing 
Routine 

This routine constructs SMBs containing 
interpreter error messages and JCL state- 
ment images, assigns space for these SMBs 
in the message class output gueue entry, 
and writes the SMBs into the entry. 

• Entry : IEFVGM 

• Exit : Return to caller 

• Tables/Work Areas : QMPA, SMB, SCD, 
IWA, JCT 

• Attributes : Reenterable, character 
dependence type C 

• Control Section: IEFVGM 
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IEFVGM1: Interpreter — Message Module 



IEFVGM8: Interpreter — Message Module 



This routine contains interpreter messages 
01-07. 

• Attributes : Non- executable 

• Control Section: IEFVGM1 



This routine contains interpreter messages 
50-57. 

• Attributes : Non-executable 

• Control Section: IEFVGM8 



IEFVGM2: Interpreter — Message Module 

This routine contains interpreter messages 
08-OF. 

• Attributes : Non- executable 

• Control Section: IEFVGM2 



IEFVGM3: Interpreter — Message Module 

This routine contains interpreter messages 
10-17. 

• Attributes : Non-executable 

• Control Section: IEFVGM3 



IEFVGM4: Interpreter — Message Module 

This routine contains interpreter messages 
18-1F. 

• Attributes : Non -executable 

• Control Section : IEFVGM4 

IEFVGM5: Interpreter — Message Module 

This routine contains interpreter messages 
20-27. 

• Attributes : Non-executable 

• Control Section : IEFVGM5 

IEFVGM6: Interpreter — Message Module 

This routine contains interpreter messages 
28-2F. 

• Attributes : Non -executable 

• Control Section : IEFVGM6 

IEFVGM7: Interpreter — Message Module 

This routine contains interpreter messages 
30-37. 

• Attributes : Non-executable 

• Control Section: IEFVGM7 



I EFVGM9: Interpreter — Message Module 

This routine contains interpreter messages 
58-5F. 

• Attributes : Non -executable 

• Control Section : IEFVGM9 

IEFVGM10: Interpreter — Message Module 

This routine contains interpreter messages 
60-67. 

• Attributes : Non-executable 

• Control Section : IEFVGM10 

IEFVGM11: Interpreter — Message Module 

This routine contains interpreter messages 
68-6F. 

• Attributes : Non -executable 

• Control Section : IEFVGM11 

IEFVGM12: Interpreter — Message Module 

This routine contains interpreter messages 
70-77. 

• Attributes : Non-executable 

• Control Section : IEFVGM12 

IEFVGM13: Interpreter — Message Module 

This routine contains interpreter messages 
78-7F. 

• Attributes : Non-executable 

• Control Section : IEFVGM13 

IEFVGM14: Interpreter — Message Module 

This routine contains interpreter messages 
88-8F. 

• Attributes : Non-executable 

• Control Section : IEFVGM14 

IEFVGM15: Interpreter Message — Module 

This routine contains interpreter messages 
90-97. 
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• Attributes: Non-executable 



• Exit: Return to caller 



• Control Section: IEFVGM15 



IEFVGM16: Interpreter — Message Module 

This routine contains interpreter messages 
A0-A7. 

• Attributes : Non-executable 

• Control Section : IEFVGM16 

IEFVGM17: Interpreter — Message Module 

This routine contains interpreter messages 
56-5D. 

• Attributes : Non- executable 

• Control Section : IEFVGM17 

IEFVGM18: Interpreter — Message Module 

This routine contains interpreter messages 
80-87, 

• Attributes : Non -executable 

• Control Section: IEFVGM18 



IEFVGM19: Interpreter — Message Module 

This routine contains interpreter messages 
3E-45. 

• Attributes : Non-executable 

• Control Section : IEFVGM19 

IEFVGM70: Interpreter — Message Module 

This routine contains interpreter messages 
38-3F. 

• Attributes : Non -executable 

• Control Section : IEFVGM70 

IEFVGM78: Interpreter — Message Module 

This routine contains interpreter messages 
08-OD. 

• Attributes : Non-executable 

• Control Section : IEFVGM78 

IEFVGS: Interpreter — Dictionary Search 
Routine 

This routine searches the refer-back dic- 
tionary for the address of a previously- 
defined SCT, SIOT, or JFCE. 

• Entry : IEFVGS 



• Tables/Work Areas : Auxiliary work 
area, IWA, QMPA f refer-back dictionary 

• Control Section: IEFVGS 



IEFVGT: Interpreter — Test and Store 
Routine 

This routine performs operations on a pa- 
rameter as indicated in the appropriate pa- 
rameter descriptor table entry. 

• Entry : IEFVGT 

• Exit : Return to keyword routine 

• Tables/Work Areas : Internal text buff- 
er # PDT f local work area, IWA 

• Control Section : IEFVGT 

IEFVHA: Interpreter — Get Routine 

This routine reads statements from the 
input stream and the procedure library. 

• Entry: IEFVHA 

• Exits : IEFVHC f IEFVHB, IEFVHAA, 
IEFSD536, IEFVGM 

• Tables/Work Areas : IWA, JCT, DCB 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHA 

IEFVHAA: Interpreter — End-of-File 
Routine 

This routine determines the conditions 
under which an end-of-f ile condition has 
occurred, and sets switches and passes con- 
trol accordingly. 

• Entry : IEFVHAA 

• Exits: IEFVHC or IEFVHN 

• Tables/ Work Areas : IWA, JCT 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHAA 

IEFVHB: Interpreter — DP * Statement 
Generator Routine 

This routine generates a "SYSIN DD * n sta- 
tement for data in the input stream, when 
no such statement was included. 

• Entry : IEFVHB 



144 



• Exits ; To IEFVHC f IEFVHA, IEFVGM 

• Tables/Work Areas : IWA, JCT 

• Attributes ; Read-only, reenterable 

• Control Section : IEFVHE 

IEFVHC: Interpreter — Continuation 
Statement Routine 

This routine determines whether the current 
statement should be a continuation, and, if 
so, determines whether it is a valid con- 
tinuation statement. 

• Entry : IEFVHC 

• Exits : TO IEFVHEB, IEFVHCE, IEFVGM 

• Tables/Work Areas : IWA, JCT 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHC 

IEFVHCB: Interpreter — Verb 
Identification Routine 

This routine identifies the verb in a con- 
trol statement, 

• Entry : IEFVHCB 

• Exits : To IEFVHE, IEFVHM, IEFVHA, 
IEFVGM, IEFVHL 

• Tables/Work Areas : IWA, JCT 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHCE 

IEFVHE: Interpreter — Router 

This routine determines the conditions 
under which it was entered, and passes con- 
trol to the appropriate routine. 

• Entry : IEFVHE 

• Exits : To IEFVHEB, IEFVHH, IEFVHEC 

• Tables/Work Areas : IWA 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHE 

IEFVHEB: Interpreter — Pre-Scan 
Preparation Routine 

This routine determines whether a message 
is required or additional work queue space 
is required before a statement is scanned. 
If so, it causes the message to be written 
or the work queue space to be assigned. 



• Entry : IEFVHEB 

• Exits: To IEFVHQ, IEFVGM, IEFVHG, 
IEFVFA 

• Tables/Work Areas : IWA, JCT, SCT, QMPA 

• Attributes : Read-only, reenterable 

• Control Section: IEFVHEB 



I EFVHEC: Interpreter — Job Validity Check 
R outine 

This routine determines whether an SCT has 
been built for the current job; if not, the 
routine constructs an SCT. 

• Entry : IEFVHEC 

• Exits : To IEFVGM, IEFVHH 

• Tables/Work Areas : IWA, JCT, SCT 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHEC 

IEFVHF: Interpreter — Post-Scan Routine 

This routine determines the conditions 
under which it was entered, and passes con- 
trol accordingly. 

• Entry : IEFVHF 

• Exits : To IEFVHG, IEFVHEB, IEFVHCB, 
IEFVHA 

• Tables/Work Areas : IWA, CWA 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHF 

I EFVHG: Interpreter — CPC Routine 

This routine writes system input data sets 
on a direct-access device. If IEFVHG is 
unable to obtain enough space to complete 
writing a data set, control passes to 
IEFVHR. If the input reaches end-of-file, 
control passes to IEFVHAA. If a /* is 
found following DD DATA, control passes to 
IEFVHA to read the next record. If a // is 
found, control passes to IEFVHC to identify 
the verb. 

• Entry : IEFVHG 

• Exits : To IEFSD536, IEFVGM, IEFVHQ, 
IEFVHAA, IEFVHA, IEFVHC, Or IEFVHB 

• Tables/Work Areas : IWA, JCT, SIOT, 
VOLT, TI0T, LWA, SCT, JFCB, UCB, QMPA, 
CWA 
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• Attributes : Read-only, reenterable 

• Control Section : IEFVHG 

• Page Reference : 61 



IEFVHH: Interpreter — Job and Step 
Enqueue Routine 

This routine places the SCT, DSNT, VOLT, 
and JCT in the job f s queue entry, and 
determines whether the interpreter is to 
enqueue jobs. 

• Entry : IEFVHH 

• Exits : To IEFKG, IEFVHQ, IEFSD532, 
IEFVHHB, IEFVHN 

• Tables/Work Areas : IWA, JCT, SCT, 
QMPA, NEL 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHH 

IEFVHHB: Interpreter — Housekeeping 
Routine 

This routine initializes for merging a 
cataloged procedure. 

• Entry : IEFVHHB 

• Exits : IEFVHA, IEFVHEE 

• Tables/Work Areas : IWA 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHHB 

IEFVHL: Interpreter — Null Statement 
Routine 

This routine determines the conditions 
under which the null statement was encoun- 
tered, and passes control to the proper 
routine. 

• Entry : IEFVHL 

• Exits : To IEFVHCB, IEFHEC, IEFVHE, 
IEFVHA 

• Tables/Work Areas : IWA, JCT 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHL 

IEFVHM: Interpreter — Command Statement 
Routine 

This routine tests for valid command verbs,, 
and, if the verb is valid, issues SVC 34 to 
schedule execution of the command. 



• Entry : IEFVHM 

• Exits : To IEFVHA, IEFVGM 

• Tables/Work Areas : IWA, JCT 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHM 

IEFVHN: Interpreter — Termination Routine 

This routine closes the input stream and 
procedure library data sets, frees main 
storage used by the interpreter, and builds 
the interpreter exit list. 

• Entry : IEFVHN 

• Exit : Return to caller 

• Tables/Work Areas : IWA, JCT, CSCB, 
QMPA 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHN 

• Page Reference : 62 

IEFVHQ: Interpreter — Queue Management 
Interface Routine 

This routine is a common interface between 
the queue management routines and the 
interpreter. If an I/C error occurs, 
IEFVHR receives control. Queue management 
may be unable to allocate space for a job's 
input data. If, in this case, the operator 
replies CANCEL to the message which is 
issued, IEFVHG receives control. 

• Entry : IEFVHQ 

• Exits : Return to caller, IEFSD536, or 
IEFVHG 

• Tables/Work Areas : IWA, JCT, QMPA, 
CSCB 

• Attributes : Read-only, reenterable 

• Control Section : IEFVHQ 

IEFVH1: Interpreter — Initialization 
Routine 

This routine initializes the interpreter; 
it obtains main storage for and initializes 
the IWA, local work areas, and DCBs. 

• Entry : IEFVH1 

• Exit : To IEFVH2 

• Tables/Work Areas : UCB, CSCB, IWA, 
DCB, local work area 
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• Attributes : Not reusable 

• Control Section : IEFVH1 

IEFVH2: Interpreter — Initialization 
Routine 

This routine opens the input stream data 
set and the procedure library data set f and 
obtains main storage for a buffer for pro- 
cedure library records. 

• Entry : IEFVH2 

• Exit : To IEFVHA 

• Tables/Work Areas : IWA f UCB, TIOT 

• Control Section : IEFVH2 

• Attributes : Not reusable 

IEFVJA: Interpreter — Job Statement 
Processor 

This routine initializes a JCT and job ACT 
from the complete logical job statement in 
the internal text buffer. 

• Entry : IEFVJA 

• Exit : To IEFVHF 

• Tables/Work Areas : IWA, job work area, 
interpreter key table, JCT, ACT, QMPA 

• Attributes : Read-only, reenterable 

• Control Section : IEFVJA 

IEFVJIMP: Termination — JOB Statement 
Condition Code Processor 

This routine tests the condition codes spe- 
cified in the JOB statement to determine 
whether the remaining steps in the job are 
to be run. 

• Entry : IEFVJ 

• Exits : To IEFVK or IEFZA 

• Tables/Work Areas : LCT, JCT, SCT 

• Control Section : IEFVJ 

IEFVJMSG: Termination — JOB Statement 
Condition Code Processor Messages 

This routine contains the messages issued 
to the programmer by the JOB statement con- 
dition code processor. 

• Entry : IEFVJMSG 

• Attributes : Non- executable 

• Control Section: IEFVJMSG 



IEFVKIMP: I/O Device Allocation — EXEC 
Statement Condition Code Processor 

This routine tests the condition codes spe- 
cified in the EXEC statement to determine 
whether the next step of the job is to be 
run. 

• Entry : IEFVK 

• Exits : IEFVS, IEFLB 

• Tables/Work Areas : JCT, LCT, SCT 

• Control Section : IEFVK 

IEFVKMSG: I/O Device Allocation — EXEC 
Statement Condition Code Processor Messages 

This routine contains the messages issued 
to the programmer by the EXEC — statement 
condition — code processor. 

• Entry : IEFVKMJ1 

• Attributes : Non-executable 

• Control Section : IEFVKMSG 

IEFVMFAK: I/O Device Allocation — Linkage 
to IEFVMLS1 

This routine passes control to entry point 
IEFVMCVL of the JFCB housekeeping module 
IEFVMLS1 via the XCTL macro instruction. 

• Entry : IEFVMCVL 

• Exit: To IEFVMCVL 



• Control Section: 



IEFVMCVL 



IEFVMLS1: I/O Device Allocation — JFCB 
Housekeeping Control Routine and Allocate 
Processing Routines 

The control routine obtains the required 
SIOTs, determines the processing required 
for each, and passes control to the appro- 
priate routine. The allocate processing 
routine performs the processing required in 
certain refer-back situations, when the 
data set is cataloged or passed, and when 
unit name is specif ied. 

• Entry : IEFVM, IEFVMCVL, IEFVMQMI, 
VM7000, VM7055, MV7055AA, VM7060, 
MV7070, MV7090, MV7130, VM7370, MV7700, 
MV7742, MV7750, MV7850, VM7900, MV7950 

• Exits : To IEFVM2LS, IEFVM3LS, 
IEFVM4LS, IEFVM5LS, IEFVM6LS, and 
IEFXCSSS 

• Tables/Work Areas : LCT, JCT, PDQ, 
SIOT, JFCB, QMPA 
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• Control Section: IEFVM1 



IEFVMLS6: I/O Device Allocation — JFCB 
Housekeeping Error Message Processing 
Routine 

This routine prepares error messages for 
the JFCB housekeeping routines. 

• Entry : IEFVMSGR 

• Exit : Return to caller 

• Tables/Work Areas : JCT, LCT 

• Control Section: IEFVM6 



IEFVMLS7: I/O Device Allocation — JFCB 
Housekeeping Error Messages 

This routine contains the messages issued 
by the JFCB housekeeping routines. 

• Entry : IEFVM7 

• Attributes : Won- executable 

• Control Section : IEFVM7 

IEFVMMS1: I/O Device Allocation — Linkage 
to JFCB Housekeeping 

This routine provides a linkage to the JFCB 
housekeeping routines for the step flush 
function. 

• Entry : IEFVM1 

| • Exit : XCTL to IEFVMLS1 

• Attributes : Read-only , reenterable 

• Control Section : IEFVM1 

IEFVPOST: I/O Device Allocation — 
Unsolicited Device Interrupt Handler 

This routine handles the posting of unsoli- 
cited device interruptions for I/O device 
allocation operating in a multiprogramming 
environment . 

• Entry : IEFDPOST 

• Exits : To IEAOPT01 or Return to caller 

• Tables/Work Areas : CSCB, ECB, TCB 

• Attributes : Read- only , reenterable, 
disabled, resident 

• Control Section: IEFDPOST 



IEFVM2LS: I/O Device Allocation — JFCB 
Housekeeping Fetch DCB Processing Routine 

This routine updates the SIOT, SCT f JFCB 
and VOLT with information required for the 
allocation of devices for the fetch DCB. 

• Entry : VM7100 

• Exit : To IEFVMLS1 

• Tables/Work Areas : LCT, SCT, SIOT, 
JFCB, VOLT 

• Control Section: IEFVM2 



IEFVM3LS: I/O Device Allocation — JFCB 
Housekeeping GDG Single Processing Routine 

This routine obtains the fully qualified 
name of a member of a generation data group 
(GDG), and completes the required informa- 
tion in the JFCB, VOLT, and SIOT for that 
member. 

• Entry : VM7150 

• Exit : To IEFVMLS1 

• Tables/Work Areas : LCT, SIOT, GDG Bias 
Count table, JFCB 

• Control Section : IEFVM3 

IEFVM4LS: I/O Device Allocation — JFCB 
Housekeeping GDG All Processing Routine 

This routine builds an SIOT, JFCB, and 
VOLT, and PDQ entries for each member of 
the GDG. 

• Entry : VM7200 

• Exit : To IEFVMLS1 

• Tables/Work Areas : LCT, SCT, VOLT, 
PDQ, SIOT, JFCB 

• Control Section: IEFVM4 



IEFVM5LS: I/O Device Allocation — JFCB 
Housekeeping Patterning DSCB Routine 

This routine establishes DCB control infor- 
mation within a JFCB. 

• Entry : VM7300 

• Exit : To IEFVMLS1 

• Tables/Work Areas : LCT, SCT, SIOT, 
DSCB, JFCB 

• Control Section: IEFVM5 
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IEFVM76: I/C Device Allocation — JFCB 
Housekeeping Unique Volume ID Routine 

This routine creates unique volume serials 
for unlabeled tape data sets, when the dis- 
position is "PASS" • 



• Entry : VM7600 



• Exit: Return to caller 



• Tables/Work Areas : SI0T, JFCB, JFCBX 



• Control Section: IEFVM76 



IEFVRRC: Reinterpretation Control Routine 

This routine passes control among the rou- 
tines that modify the queue entry of a 
restart step so that they appear as they 
were prior to the initiation of the step. 



• Entry : IEFVRRC, IEFVRRCA, IEFVRRCB 



• Exit: Return to caller 



• Attributes : Read-only reenterable 

• Tables/Work Areas : NEL, JCT, SCT, 
SI0T, JFCB, JFCBX, VOLT, SMB, DSENQ, 
SCD, DSB, QMPA 

• Control Section: IEFVRRC 



IEFVRR1: Dequeue Interface Routine 

This routine interfaces with queue manage- 
ment to cause a specific job to be dequeued 
and the JCT for that job to be read into 
main storage. 

• Entry : IEFVRR1 

• Exit : Return to caller 

• Tables/Work Areas : QMPA, JCT 

• Attributes : Read-only, reenterable 

• Control Section : IEFVRR1 

IEFVRR2: Table Merge Routine 

This routine merges the reinterpreted queue 
entry tables of a restart step with the 
original queue tables for that step. 



• Entry : IEFVRR2, IEFVR2AE 

• Exit : Return to caller 

• Tables/ work Areas : QMPA, JCT, ACT, 
SMB, SCT, SI0T, JFCB, DSENQ, VCLT , 
JFCBX, NEL 

• Attributes : Reenterable 

• Control Section: IEFVRR2 



IEFVRR3: Reinterpretation Delete/Enqueue 
Routine 



This routine deletes the reinterpreted 
input and output queue entries of a restart 
step, constructs the internal JCL necessary 
for processing a checkpoint restart, and 
reenqueues the job f s queue entry. 

• Entry : IEFVRR3, IEFVR3AE 

• Exit : Return to caller 

• Tables/work Areas : QMPA, JCT, SCT, 
SI0T, JFCB 

• Attributes : Reenterable 

• Control Section: IEFVRR3 



IEFVSDRA: Restart Activation Routine 



This routine issues a START Restart Reader 
command for one or more jobnames. This 
routine is entered from IEFSD168 during a 
problem program restart or IEFSD305 during 
a warm start. 

• Entry : IEFVSDRA 

• Exit : Return to caller 

• Table s/Work Areas : CSCB, CVT, TCB 

• Attributes : Reenterable 

• Control Section : IEFVSDRA 

IEFVSDRD: Restart Determination Routine 



This routine initiates automatic restarts. 

• Entry : IEFVSDRD 

• Exit : To IEFSD305 

• Tables/Work Areas : JCT, SCT, QMPA, 
CVT, TI0T, LCT 

• Attributes : Reenterable 

• Control Section: IEFVSDRD 
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IEFVSD12: Interpreter — CPO Allocation 
Subroutine 

This routine sets up a JFCB and allocates 
space on a direct-access device for a sys- 
tem input data set, 

• Entry : IEFSD012 

• Exit ; Return to caller 

• Attributes : Reenterable 

• Tables/Work Areas : IWA, QMPA, LWA, 
SIOT, TIOT, UCB, JFCB, JCT f CSCB 

• Control Section : IEFSD012 

• External References : IEFVHQ 



IEFVSD13: Interpreter — SCD Construction 
Routine 

This routine constructs an SCD entry for 
each system output class defined for a job, 
and assigns space for all DSBs that will be 
required. 

• Entry : IEFSD090 

• Exit : Return to caller 

• Tables/Work Areas : IWA, 2MPA, DD work 
area, SCD, SCT, SIOT, JCT, JFCB 

• Control Section : IEFSD090 
IEFVSMBR: SMB Reader Routine 



This routine reads the SMBs associated with 
a restarting job and converts the JCL sta- 
tements to their original format. 

• Entry : IGC0005B 

• Exits : If called during restart reader 
processing, return to caller; if called 
during restart, XCTL to the first load 
of restart housekeeping. 

• Tables/Work Areas : QMPA, DCB, JCT, 
SMB, RRCWKAR, SCT 

• Attributes : Reenterable 

• Control Section : IEFVSMBR 

IEFWA000: I/O Device Allocation — Demand 
Allocation Routine 

This routine establishes data set device 
requirements, and allocates in response to 
specific unit requests. 

• Entry : IEFWA000, IEFUCBL 



• Exits : To IEFWDOGO, IEFX3000, IEFX5000 

• Tables/Work Areas : UCB Address List, 
DMT, UCB, LCT, SCT, SIOT, VOLT, AWT 

• Control Sections : IEFWA7, IEFWA002 

IEFWCFAK: I/O Device Allocation — Linkage 
Module 

This routine passes control to the TIOT 
construction routine. 

| • Entry : IEFWC000, IEFWC002 

• Exit : To IEFWCIMP 

| • Control Section : IEFWC000, IEFWC002 

IEFWCIMP: I/O Device Allocation — TIOT 
Construction Routine 

This routine calculates the main storage 
required for the TIOT, builds the TIOT, and 
processes requests for direct-access space. 

• Entry : IEFWC000 

• Exits : TO IEFXJIMP, IEFWDIMP 

• Tables/Work Areas : JCT, SCT, LCT, 
SIOT, VOLT, AWT, TIOT 

• Control Section : IEFWC000 

IEFWDFAK: I/O Device Allocation — Linkage 
Module 

This routine passes control to the external 
action routine. 

• Entry : IEFWD000 

• Exit : To IEFWD000 

• Control Section : IEFWD000 

IEFWDQOO: I/O Device Allocation — 
External Action Routine 

This routine causes the correct volumes for 
the step to be mounted on the appropriate 
units. 

| • Entry : IEFWD000, IEFWDMSG 

• Exits : To IEFXT000, IEFWU1SD, IEFXK000 

• Tables/Work Areas : SCT, LCT, TIOT, UCB 

| • Control Section : IEFWD000, IEFWDMSG 

IEFWD001: I/O Device Allocation — 
External Action Messages 

This routine contains a directory and the 
messages used in the external action 
routine. 
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• Entry : IEFWD001 

• Attributes : Non -executable 

• Control Section: IEFWD001 



IEFWSTRT: I/C Device Allocation — Message 
Module 

This routine contains the message issued to 
the operator when a job is started and the 
messages issued to the operator when a job 
is terminated due to ABEND, condition 
codes, or JCL errors. 

• Entry : IEFWSTRT 

• Attributes: Non-executable 



• Control Section; 



IEFWSTRT 



IEFWSWIN: 



I/C Device Allocation — Linkage 



Module 

This routine passes control to the decision 
allocation routine. 

• Entry : IEFWSWIT 

• Exit: To IEFX5000 



• Control Section: 



IEFWSWIT 



IEFWTERM: Termination — Message Module 

This routine contains the message issued to 
the operator when a job is terminated norm- 
ally, or when it is terminated because of a 
JCL error found in the interpreter or 
initiator. 

• Entry : IEFWTERM 

• Attributes : Non -executable 

• Control Section : IEFWTERM 

IEFXAMSG: I/O Device Allocation — Message 
Module 

This routine contains the messages issued 
by the allocation control routine. 

• Entry : IEFXAMSG 

• Attributes : Non-executable 

• Control Section: IEFXAMSG 



IEFXCSSS : 



I/C Device Allocation — 



Allocation Control Routine 

This routine calculates table space 
reguirements and obtains the main storage 
for the tables used or built during 
allocation. 



• Entry : IEFXA 

• Exits : To IEFXJ f IEFWA, IEFWC 

• Tables/Work Areas : JCT, SCT, LCT, UCB, 
SIOT, VOLT, AWT 

• Control Section : IEFXA 

I EFXH000: I/O Device Allocation — 
Separation Strikeout Routine 

This routine strikes from AWT entries, the 
bits corresponding to devices that would 
violate separation or affinity reguests. 

• Entry : IEFXH000 

• Exit : Return to caller 

• Tables/Work Areas : LCT, AWT, AVT, UCB 

• Control Section: IEFXH000 



I EFXJFAK: I/O Device Allocation — linkage 
Module 

This routine passes control to the alloca- 
tion recovery routine. 

• Entry : IEFXJ000 

• Exit: To IEFXJIMP 



• Control Section: 



IEFXJ000 



IEFXJIMP: I/O Device Allocation — 
Allocation Recovery Routine 

This routine informs the operator of the 
allocation recovery options available, and 
passes control to the proper routine to 
comply with his reguest. 

• Entry : IEFXJ000, IEFV15XL, IEFXJX5A 

• Exits : TO IEFXCSSS, IEFSD095, IEFW41SD 

• Tables/Work Areas : LCT, AWT, JCT, CVT, 
UCB, SCT, SIOT 

• Control Section: IEFXJ000 



I EFXJMSG: I/O Device Allocation — 
Allocation Recovery Messages 

This routine contains the messages used by 
the allocation recovery routine. 

• Entry: MSRCV, MSSYS, MSCFF 

• Attributes : Non-executable 

• Control Section: IEFXJMSG 
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IEFXKIMP: I/O Device Allocation — 
Non-Recovery Error Routine 

This routine cancels the step when a lack 
of available devices has been discovered 
after the TICT is constructed. 

• Entry : IEFXKOOO 

• Exit : To IEFW41SD 

• Tables/Work Areas : LCT, SCT, UCB, TIOT 

• Control Section : IEFXKOOO 

IEFXKJMSG: I/C Device Allocation — 
Non-Recovery Error Routine Messages 

This routine contains the messages used by 
the non- recovery error routine. 

• Entry : IEFXKMSG 

• Attributes : Non-executable 

• Control Section: IEFXKMSG 



IEFXTOOD: I/O Device Allocation — Space 
Request Routine 

This routine obtains space on direct-access 
devices for requesting data sets. 

• Entry : IEFXT000 

• Exits : To IEFW41SD, IEFXKOOO, IEFWD000 

• Tables/Work Areas : LCT, TIOT, UCB f 
JCT, SIOT, JFCB, PDQ 

• Control Section : XTTPOO, IEFXT000 

IEFXT002: I/O Device Allocation — VARY 
Command Interface TIOT Compression Routine 

This routine reduces the TIOT to its final 
size and provides an interface with the 
VARY command . 

• Entry : IEFXT002, XTTRDJ, XTTEB3, 
XTTEA1, XTTEAO 

• Exits : to IEFXKIMP, IEFXT003, IEF41FAK 

• Tables/Work Areas : LCT, TIOT, UCB, 
JCT, SIOT, JFCE 

• Control Section : IEFXT002 

IEFXT003: I/C Device Allocation — DADSM 
Error Recovery Routine 

This routine determines what action should 
be taken when the request for space on a 
particular volume fails . 



• Entry : IEFXT003, XUUH06, XUUBOO 

• Exits : To IEFXTOOD, IEFXT002 

• Tables/Work Areas : LCT, TIOT, UCB, 
JCT, SIOT, JFCB 

• Control Section: IEFXT003 



IEFXVMSG: 



I/O Device Allocation 



Automatic Volume Recognition Messages 

This routine contains the messages used by 
the automatic volume recognition (AVR) 
routine . 

• Entry : IEFXVMSG 

• Attributes : Non-executable 

• Control Section : IEFXVMSG 

IEFXVNSL: I/O Device Allocation — 
Automatic Volume Recognition — 
Non-Standard Label Routine 

This routine processes non-standard labels 
for the AVR routine,. 

• Entry : IEFXVNSL 

• Exit : Return to caller 

• Control Section : IEFXVNSL 

IEFXV001: I/O Device Allocation — 
Automatic Volume Recognition Routine 

This routine finds and allocates volumes 
pre-mounted by the operator. 

• Entry : IEFXV001 

• Exits : IEFWC000, IEFX5000, IEFXJ000 

• Tables/Work Areas : JCT, SCT, AWT, AVT, 
VOLT, SIOT, LCT, UCB 

• Control Section : IEFXV001 
IEFXV002: I/O Device Allocation — 



Automatic Volume Recognition g Label 
Processing 



This routine reads the label of a newly 
mounted volume, extracts the serial number, 
and places it into the UCB for the corres- 
ponding device. 

• Entry : IEFXV002 

• Exits: To IEFXVNSL via CALL, return to 
caller. 

• Tables/work Areas : LUT, UCB, CVT, DEB, 
IOB 
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• Attributes : Reusable 

• Control Section : IEFXV002 

IEFX300A: I/O Device Allocation — Device 
Strikeout Routine 

This routine modifies the primary and 
secondary bit pat-terns in AWT entries to 
complete the allocation to a data set. 

• Entry : IEFX3000, X33E42 

• Exit: Return to caller 

• Tables/Work Areas : AWT f AVT f UCB, LCT 

• Control Section : IEFX3000 

IEFX5000: I/O Device Allocation — 
Decision Allocation Routine 

This routine selects devices for data sets 
with multiple unit possibilities. 

• Entry : IEFX5000, XIIE32, X55C86, 
X55D3G 

• Exits : To IEFWC000, IEFXJOOO 

• Tables/Work Areas : LCT, AWT, AVT f UCB 

• Control Section: IEFX5000 



IEFYNIMP: Termination — Step Termination 
Control Routine 

This routine passes control among the 
modules of the step termination routine 
and, when required, passes control to the 
job termination routine. 



Entry : 



IEFYN 



• Exits : To IEFW22SD, IEFYPJB3, IEF- 
VJIMP, IEFZAJB3, IEFRPREP 

• Tables/Work Areas : JCT, SCT, LCI 

• Control Section : IEFYN 

IEFYNMSG: Termination — Step Termination 
Control Routine Messages 

This routine contains the messages required 
for the step termination control routine. 

• Entry : IEFYNMSG, STRMSG01 

• Attributes : Non- executable 

• Control Section: IEFYNMSG 



I EFYPJB3: Termination — Step Termination 
D ata Set Driver Routine 

This routine obtains SICTs and to pass con- 
trol to the disposition and unallocation 
routine. 



• Entry : IEFYP 

• Exits: To IEFZG, IEFYNIMP 

• Tables/Work Areas : LCT, TIOT, UCB, 
QMPA, SIOT, TCB 

• Control Section : IEFYP 

I EFYPMSG: Termination — Step Termination 
Messages 

This routine contains the messages required 
by the step termination routine. 

• Entry: IEFYPMSG, YFPMSG1, YPPMSG2 

• Attributes : Non-executable 

• Control Section: IEFYPMSG 



IEFYSVMS: Termination — Message Blocking 
Routine 

This routine blocks system messages into 
SMBs, and places SMBs into the message 
class queue entry. 

• Entry: IEFYS 

• Exit : Return to caller 

• lables/Work Areas : LCT, SCT, SMB 

• Attributes : Reenterable 

• Control Section: IEFYS 



IEFYTVMS: Termination — DSB Processing 
R outine 

This routine places data set blocks in the 
space reserved for them in the output queue 
entries. 

• Entry : IEFYT 

• Exit : Return to caller 

• Tables/ Work Areas : JCT, SCT, TICT, 
SIOT, QMPA, DSCB, LCT, CVT, JFCB 

• Attributes : Reenterable 

• Control Section: IEFYT 
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IEFZ AJB3 : 



Termination 



Job Termination 



Control Routine 

This routine provides entry to the job ter- 
mination routine, obtains PDQ blocks, and 
passes control to the disposition and unal- 
location routine, 

• Entry : IEFZA 

• Exits : To IEFZGJ, IEFW31SD 

LCT, JCT, PDQ, UCB, 



• Tables/Work Areas : 

QMPA 



• Control Section: IEFZA 



IEFZGJB1: Termination — Disposition and 
Deallocation Routine 

This routine directs the disposition and 
deallocation of those data sets that remain 
to be processed at job termination: passed 
data sets that were not received, and 
retained data sets that were not referred 
to. 



• Entry : IEFZGJ, ZPOQM 

• Exit : Return to caller 

• Tables/Work Areas : JCT, PDQ, JFCB, 
LCT, QMPA, UCB 

• Control Section: IEFZGJ 



• Tables/Work Areas : LCT, PDQ, SIOT, 
TIOT, UCB, JFCB, QMPA 

• Control Section: IEFZG 



IEFZHMSG: Termination — VARY Command 
Interface and Disposition and Deallocation 
Message Routine 

This routine prepares messages to the pro- 
grammer and to the operator for the dispo- 
sition and allocation routines. It also 
provides an interface with the VARY 
command. 

• Entry : IEFZH, ZG0E60, ZK0D1, ZK0E1, 
XPS631 

• Exit : Return to caller 

• Tables/Work Areas : LCT, QMPA, SMB 

• Control Section: IEFZH 



IEF078SD: System Output Writer — Linkage 
Module 

This routine transfers control to module 
IEFSD078. 

• Entry : IEFSD078 

• Exit : To IEFSD078 

• Attributes: Reenterable 



IEFZGMSG: Termination — Disposition and 
Deallocation Messages 

This routine contains the messages required 
for the disposition and deallocation rou- 
tine (IEFZGJB1). 



• Entry : IEFZGMSG 

• Attributes : Non- executable 

• Control Section : IEFZGMSG 

IEFZGST1: Termination — Disposition and 
Deallocation Routine 

This routine directs the disposition of 
data sets as specified in the DISP field of 
the DD statement, and makes the associated 
units available for allocation to other 
data sets. 

• Entry : IEFZG, ZP0QMGR1 

• Exit: Return to caller 



IEF079SD: System Output Writer — Linkage 
Module 

This routine transfers control to IEFSD079. 

• Entry : IEFSD079 

• Exit : To IEFSD079 

• Attributes : Reenterable 

IEF082SD: System Output Writer — Linkage 
Module 

This routine passes control to the system 
output writer main processing routine. 

• Entry : IEFSD082 

• Exit : To IEFSD082 

• Control Section : IEFSD082 

IEF083SD: System Output Writer — Linkage 
Module 

This routine passes control to the system 
output writer command processing routine. 
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• Entry : IEFSD083 

• Exit : IEFSD083 

• Control Section : IEFSD083 

IEF300SD: System Restart — Linkage Module 

This routine provides a linkage to the sys- 
tem restart initialization routine. 

• Entry : IEFSD300 

• Exits : To IEFSD300, IEFSD055 

• Attributes : Reenterable 

IEF3Q4SD: System Restart — Linkage Module 

This routine provides a linkage to the sys- 
tem restart scratch data sets routine. 

• Entry : IEFSD304 

• Exits : To IEFSD304, IEFSD055 

• Attributes : Reenterable 

• Control Section : IEFSD304 

IEF41FAK: I/O Device Allocation — Linkage 
Module 

This routine provides a linkage to the 
allocation exit routine during step flush. 

• Entry : IEFW41SD, IEFW1FAK, IEFW2FAK 

• Exit : To IEFW41SD 

• Attributes : Read-only, reenterable 

• Control Section : IEFW41SD 

IGC0103D: SVC — Master Command EXCP 
Routine 

This routine processes the MOUNT Command. 



• Entry : IGC0103D 



• Attributes : Reenterable, transient 



• Control Section: IGC0103D. 



• Page Reference : 



IGF2603D: SVC 34 — Machine Status Control 
Routine 

This routine is available only for the 
model 85. It processes the status parame- 
ter of the MODE command. 



• Entry : IGF2603D 



• Exit: IGF2703D 



• Tables/Work Areas : CVT, XSA 



• Attributes : Reenterable, read-only, 
self -relocating 

• Control Section: IGF2603D 



IGF2703D: SVC34 - Machine Status Control 
Routine 



This routine is available only for the 
model 85. It processes all parameters of 
the MODE command but the status parameter. 

• Entry : IGF2703D 

• Exit : Return to issuer of SVC 34 

• Tables/Work Areas : CVT, XSA 

• Attributes : Reenterable, read-only, 
self -relocating 

• Control Sections: IGF2703D 
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Appendix C: Flowcharts 



This appendix includes the MFT flowcharts 
that are different from MVT. For the flow- 
charts on allocation, termination, and sys- 



tem restart, see IBM System/360 Operating 
System: MVT Job Management, Program Logic 
Manual ,,, Form Y28-6660. 



Chart 01 . Task Dispatcher (Without Time Slicing) 



Note - 'Old' Is the TCB Address 
of the Task Currently 
in Control. 'New' Is the 
TCB Address of the 
Task to be Given Control. 



( Entry J 




Enqueue Timer 
Element 



(Load 'Old' PSW^V 
to Return ) 



Schedule 
Asynchronous 
Exit Routines 




■New' = TCB to 
Be Dispatched 




Place 'Old' 

Task in Wait 

State 



Dequeue Timer 
Element 




Examine 'Old' 
TCB 




Find Next TCB 
on Queue 
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Chart 02, Task Dispatcher (With Time Slicing) 
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Chart 03. ABEND and DAJR Control Flow (Part 1 of 2) 
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Chart 04. ABEND and DAR Control Flow (Part 2 of 2) 
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Chart 05. Small Partition Routine (Part 1 of 4) 
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Chart 06. Small Partition Routine (Part 2 of 4) 
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Chart 07. Small Partition Routine (Part 3 of 4) 
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Chart 08. Small Partition Routine (Part 4 of 4) 
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Chart 09, Master Scheduler Task 
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Chart 10. Queue Search 
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Chart 11. Queue Manager Table Breakup Routine 
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Chart 12. Master Scheduler Resident Command Processor 



IEECIR50 




Note - The Resident 

Command Processor 
Never Terminates 





IEESD562 


Yes 


Job Queue 
Search Routines 


Link 





IEEDFIN1 


Yes 


Define Routines 


Link 



Appendix C: Flowcharts 167 



phart 13. SVC 34 Command Processing (Part 1 of 3) 
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Chart 14. SVC 34 Command Processing (Part 2 of 3) 
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Chart 15. SVC 34 Coirimand Processing (Part 3 of 3) 
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Chart 16. Communications Task 
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Chart 17. IEFSD518 - Partition Recovery Routine 
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Chart 18. Initiator Control Flow 
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Chart 19. Job Selection Routine (Sheet 1 of 5) 
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Chart 20. Job Selection Routine (Sheet 2 of 5) 
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Chart 21. Job Selection Routine (Sheet 3 of 5) 
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Chart 22. Job Selection Routine (Sheet 4 of 5) 
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Chart 23. Job Selection Routine (Sheet 5 of 5) 
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Chart 24. Reader/Interpreter (Sheet 1 of 3) 
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Chart 25. Reader/Interpreter (Sheet 2 of 3) 
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Chart 26. Reader Interpreter (Sheet 3 of 3) 
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Chart 27 . JCL Statement Processor 
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Chart 28. Job and Step Enqueue Routine 
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Chart 29. Transient Reader Suspend Routine 
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Chart 30. Transient Reader Restore Routine 
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Chart 31. System Output Writer Control Flow 
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Chart 32. System Output Writer 
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Chart 33 . System Task Control 
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following step execution 41 
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Error handling 36-37 
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Interruption supervision 21,45-46 
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IPL (see initial program loading) 
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JCL (see job control language) 
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JCT (see job control table) 
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Job scheduler 39 
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Link parameter list (LPL) 65 

Linkage control table (LCT) 87 , 89, 71 
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Log task 21,46-47 
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LpRB (see loaded program request block) 
LRB (see loaded request block) 
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M/S resident data area 
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Machine check handler (MCH) 36 
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Main storage supervision 21,35 

Master scheduler task (MST) 46-53,35 

dispatching 21,24-25 
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MCS (see multiple console support) 

MODE command 47, 40 

MOUNT command 47, 40 
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Multiple console support (MCS) 46 

Must complete . 33 



NEL (see interpreter entrance list) 

NIP (see nucleus initialization program) 

No work ECB 59 

Nondispat enable tasks .................. 24 
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SVC routines (see SVC transient area) 

writers (see system output writers) 

Nucleus 11,18 
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CNGFX/OFFGFX (see VARY command) 
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OPEN macro instruction 73-74 

Open/close/ end-of- volume . * 10-11 
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Output writer 72-73 

Overlay supervisor 36,21 
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definition ....................... 50-53 
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recovery 71 

task control block 21-23 
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(PIB) 92-93,18,63 
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Passed data set queue (PDQ) 97 
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POST macro instruction 32 

PRB (see program request block) 

Priority 

dispatching 9,21-27 

job 54-55 

Program request block (PRB) 33 

Program status word (PSW) 37 

Protection keys, storage 9,12,21 
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Purge routine 70-71 



QCB (see queue control block) 

QCR (see queue control record) 

QEL (see queue element) 
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Qname 32 

Queue control block (QCB) 32 

Queue control record (QCR) 49,54-60 

Queue element (QEL) 32 

Queue manager 54-60 

functions 54 
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RAM (see resident access method) 
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queue, and system task control) 
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Recording/Recovery routines 36-37 
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RJE (see remote job entry) 
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SPIL (see small partition information list) 

SQA (see system queue area) 
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STC (see system task control) 

Step control table (SCT) 94-95,96,68 
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System environment recording ........... 37 

System initialization 18, 48-49 

System input readers 

(see reader/ interpreter) 
System interruption request block (SIRB) 30 
System output class directory (SCD) .... 68 
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